云函数中直接调用uniCloud.database()即可初始化数据库连接，无需额外SDK或连接字符串；推荐在exports.main内部每次调用，再通过db.collection('xxx')获取集合，避免外层复用导致并发异常。
直接在云函数里调用 unicloud.database() 就能操作数据库，不需要额外安装 sdk 或配置连接字符串。但必须确保云函数已部署、数据库集合已创建，且前端已正确调用。
云函数里怎么初始化数据库连接
所有数据库操作都从 uniCloud.database() 开始，它返回一个数据库实例。这个调用是轻量的，每次请求都可安全调用，无需手动管理连接池（uniCloud 内部已做复用）。
- 不要用
require('mongodb')或new MongoClient()—— 这在 uniCloud 环境不支持，会报错 - 不要在
exports.main外层定义db变量并复用——虽然看似省事，但 context 隔离机制下可能引发并发读写异常 - 推荐写法：在
main函数内部调用uniCloud.database()，再链式获取集合：db.collection('messages')
增删改查的常用写法和易错点
云数据库 API 是 Promise 风格，必须用 await；错误不会自动抛出，需检查 res.result.affectedDocs 或 res.errCode。
-
查询：
collection.where({ nickname: '张三' }).get()—— 注意where后必须跟get()，只写where不会执行 -
添加：
collection.add({ content: 'hello', createTime: Date.now() })——add()返回的是{ id: 'xxx' }，不是完整文档 -
删除：
collection.where({ _id: event.id }).remove()—— 不能直接传{ _id: 'xxx' }给remove()，必须用where包裹 -
更新：
collection.where({ _id: event.id }).update({ isPublic: false })——update()不支持直接传整个对象覆盖，只能传字段键值对
为什么前端调用后数据库没变化
常见原因不是代码逻辑错，而是环境或权限卡点：
- 云函数未成功部署：HBuilderX 中右键云函数文件 → “上传并部署”，控制台无报错 ≠ 部署成功，要确认右下角弹出“部署成功”提示
- 数据库集合名拼写不一致：云函数里写
collection('messages')，但控制台建的是message（少 s），查不到也写不进 - 前端调用时没等
await完成：比如在onLoad里直接uniCloud.callFunction(...)却没加await，导致后续逻辑提前执行 - 云函数返回值含不可序列化内容：比如
return { time: new Date() }，Date对象会被 JSON 序列化为null，看起来像“没返回数据”
最常被忽略的是：云函数里写的 console.log 日志，必须去 uniCloud 控制台「日志」页查看，前端开发者工具里看不到——很多问题其实日志里早有 errCode: 401 或 collection not found 提示，只是没去看。
