unicloud云数据库不支持实时订阅,仅提供一次性快照读取;可行方案包括轮询(配合updated_at字段)、第三方推送或自建websocket服务。

uni-app 本身不支持数据库层面的「数据订阅」(即类似 Firebase 的实时监听),uniCloud 的云数据库也**没有原生的 WebSocket 订阅机制**。所谓“实时更新”,必须靠前端主动轮询、服务端推送(需额外架构)或客户端监听本地变更后手动同步——别被“订阅”这个词带偏了。
uniCloud 云数据库不支持 onSnapshot 或实时监听
很多人在查 onSnapshot、watch、onChanges 这类关键词,但 uniCloud 官方 SDK 明确不提供这类 API。它的 db.collection().where().get() 是一次性快照读取,返回后就断开,不会持续监听服务端变化。
- 尝试调用
db.collection().watch()会直接报错:TypeError: db.collection(...).watch is not a function - 即使在云函数里用 Node.js SDK,阿里云/腾讯云后端也不开放长连接通道给前端直连
- uniCloud 的「响应式」仅限于前端
uni-data-picker、uni-data-checkbox等组件对localdata的响应,跟云数据库无关
可行的“伪实时”方案:轮询 + 时间戳字段
最轻量、兼容性最好、无需额外服务的方案是加一个 updated_at 字段,前端定时拉取比上次时间新的记录。
- 数据库表中必须有
updated_at(Date类型)字段,并在每次写入时自动更新(可用 DB Schema 的"force"规则或云函数保证) - 前端用
setInterval调用db.collection('xxx').where('updated_at > ' + lastTime).get(),拿到增量后合并到本地列表 - 轮询间隔建议 ≥ 3s,避免触发云数据库频控(尤其免费版 QPS 限制明显)
- 注意处理并发写入导致的
updated_at冲突:两个更新在同一毫秒发生,可能漏掉一条
需要真实时?得走云函数 + 第三方推送通道
如果业务强依赖毫秒级响应(比如聊天、协作白板),uniCloud 自身做不到,必须引入外部能力:
- 微信小程序内可用
wx.getPusher()(仅限已开通「消息推送」类目的认证主体),配合云函数调用uniCloud.callFunction({ name: 'pushMsg' })向指定用户发透传消息,前端再onPush监听并刷新数据 - App 或 H5 端可接入极光、个推等第三方推送 SDK,云函数通过 HTTP 请求触发推送,前端收到后拉取最新数据
- 自建 WebSocket 服务(部署在阿里云 ECS 或腾讯云 TKE):云函数写完数据后,用
uniCloud.httpclient推送变更事件到 WebSocket 服务,再广播给在线客户端——但这已脱离 uniCloud “serverless” 范畴
容易忽略的关键点
很多开发者卡在“为什么 onUpdated 不触发”或“collection.watch 报错”,本质是混淆了概念。uniCloud 的「云数据库」定位是 serverless 文档型存储,不是实时数据库。它不维护客户端长连接,也不做变更广播。所有“实时感”都靠你控制节奏:轮询时机、增量判断逻辑、本地缓存与远程数据的 merge 策略——这些细节没处理好,就会出现界面卡顿、重复渲染、状态不一致等问题。











