uniCloud 不支持数据库实时监听，无 watch 或 change stream 接口；“实时”需通过云函数调用 uniCloud.getPushManager 主动推送 CID 实现，客户端须正确配置并上报 CID。
uni-app 无法直接“实时推送” uniCloud 数据库变更，所谓“实时订阅”本质是客户端主动轮询或服务端主动下发——而 uniCloud 目前只支持通过 uniCloud.getPushManager 发送消息，不提供数据库变更事件的自动广播机制。
uniCloud 数据库没有内置 real-time listener
你写 db.collection('orders').watch() 或期待类似 Firebase 的监听回调，会报错或静默失败。uniCloud 的云数据库（MongoDB）本身不暴露 WebSocket 或变更流（change stream）接口给前端；uniCloud.db API 里根本没有 watch、onSnapshot 这类方法。
- 所有数据库读写仍走 HTTP 请求，即
collection.get()/collection.add()等，每次都是独立请求 - 所谓“实时”，只能靠客户端自己定时拉取（如
setInterval+get()），或由业务触发后端推送（比如订单状态更新 → 云函数调uniCloud.getPushManager推 CID） - 即使开了「响应式数据」开关（在 HBuilderX 项目设置里），也只是 Vue 层面的响应式，不是数据库层的实时同步
用云函数 + UniPush 模拟“准实时”推送
真正能落地的方案，是把数据库变更转化为“可推送事件”：当某条记录被修改时，由云函数捕获并主动推送给对应设备。
- 不能依赖数据库自动通知，必须手动在写入逻辑里加推送调用——例如在订单云函数
update-order的最后，加一段uniCloud.getPushManager调用 - 推送目标必须是
push_clientid（即 CID），不是用户 ID；CID 需提前从客户端获取并存到用户表或关联表中 - 云函数内调用
uniCloud.getPushManager时，appId必须和开发者中心 uniPush 页面显示的一致，填错一个字符就返回errCode: 401 - Android 端若收不到，先确认 manifest.json 里
"huawei"/"xiaomi"配置是否和厂商后台逐字一致，以及是否已开启系统级自启动权限
客户端如何拿到并上报 CID
uni.getPushClientId() 不是随时都能调通，它高度依赖环境配置是否完整。
- 真机调试必须用「自定义基座」，默认基座无厂商 SDK，调用直接返回空字符串
- Android 12+ 必须在 manifest.json 的
permissions中显式声明"android.permission.POST_NOTIFICATIONS"，否则连弹窗都不出现 - iOS 需上传有效的 APNs 证书（P12 或 p8），且在开发者中心开启推送能力，否则
onPush事件根本不会触发 - CID 应在
onLaunch里获取并缓存（如存uni.setStorageSync），避免多次调用导致延迟或重复
别踩“伪实时”陷阱
有人试图用 uniCloud.callFunction 配合短间隔轮询（如 2s 一次），这在弱网或后台时极易耗电、卡顿，且服务端压力陡增；也有人想用 WebSocket 自建通道，但 uni-app 在 iOS 后台会被系统挂起，连接断开后无法恢复。
真正稳定的做法，是把“实时性”让渡给业务语义：订单支付成功 → 立即触发云函数推送；客服回复 → 服务端写库 + 推 CID；而不是追求毫秒级同步。复杂点在于 CID 绑定关系要维护好，容易被忽略的是：用户多设备登录时，一个账号可能对应多个 CID，推送前得查全量再发，不能只存最新一个。
