微信开发者工具连接云数据库的配置与查询方法

更新时间:2026-07-14 10:59

微信开发者工具本身不是用主机地址和密码去直连数据库。本篇连接的是微信·云开发文档型数据库:项目绑定云开发环境后,用环境ID初始化,再通过wx.cloud.database()访问集合。需要连接MySQL时应使用CloudBase关系型数据库SDK或云函数,不能把MySQL账号密码放进小程序前端。

在开发者工具里准备云环境和集合

使用有效的小程序AppID打开项目,点击开发者工具中的云开发并创建或选择环境。记下当前环境ID,再进入数据库,新建一个测试集合,例如todos,手工添加一条不含个人信息的记录。集合名称区分字符,后面的代码必须完全一致。

微信开发者工具连接云数据库的配置与查询方法

在集合的数据权限中选择符合业务的规则。私人数据可使用仅创建者读写,管理任务可通过云函数或管理端处理。不要为了测试方便把生产集合长期设置为所有用户可写。

在小程序代码里初始化并查询集合

在app.js使用实际环境ID初始化云开发,把占位内容替换为开发者工具中实际环境ID:

App({ onLaunch() { wx.cloud.init({ env: '你的云开发环境ID' }) } })

在页面脚本中获取数据库引用并查询刚创建的集合:

const db = wx.cloud.database(); db.collection('todos').limit(10).get().then(res => console.log(res.data)).catch(err => console.error(err))

重新编译,在开发者工具Console中看到测试记录数组,且控制台中的集合记录与查询结果一致,就说明环境和集合已连通。提示environment not found时核对环境ID和项目AppID。提示collection not exist时核对集合名和所在环境。提示permission denied时检查集合权限与当前登录身份,不要反复修改查询代码。