unicloud 多端用户统一需依赖 uni-id 体系，因各端 login 返回的 code/token 无跨端唯一性；uni-id 服务端生成全局 uid 并绑定各端凭证，须确保同 servicespace、同 dcloud appid、同一身份源登录。
uniCloud 是 uni-app 官方推荐的云开发方案，它天然支持多端（H5、小程序、App）用户身份统一管理——但前提是必须用 uni-id 体系，而不是自己拼 token 或调用各平台原生登录 API 后自行组装用户标识。
为什么不能直接用各端 uni.login() 结果当用户 ID？
各端 uni.login() 返回的 code 或 token 仅用于换取临时凭证，本身不具备跨端唯一性：微信小程序的 openid、支付宝的 userId、H5 的 session key 都是隔离的。直接存这些值会导致同一用户在不同端登录后生成多个“假用户”，权限、数据、订单全断开。
正确做法是让 uni-id 在服务端统一映射：用户首次在任一端登录后，uni-id 会生成一个全局唯一的 uid，并把各端的原始凭证（如微信 openid、支付宝 authCode）绑定到该 uid 下。
如何配置 uni-id 实现多端统一认证？
关键不是前端怎么调，而是服务端是否启用 uni-id 并完成跨平台绑定逻辑。步骤如下：
- 在
uniCloud云函数中安装并初始化uni-id插件（通过 HBuilderX 右键“云函数” → “创建云函数” → 选择uni-id-co） - 确保
uni-config-center中已配置各平台 AppID 和密钥（mp-weixin、mp-alipay、app等），否则无法完成第三方凭证解析 - 前端统一调用
uni.login({provider: 'xxx'})，不手动处理 code；后续所有登录流程由uni-id-co云函数接管 - 用户首次登录时，
uni-id-co自动创建uid并记录绑定关系；再次从其他端登录，只要传入有效凭证，就会查到已有uid并复用
uni-id 的跨端绑定实际生效条件
不是“只要装了插件就自动统一”，必须满足以下三点，否则仍会生成新用户：
- 各端使用的
uniCloud服务空间必须是同一个（serviceSpace一致），否则uni-id数据库表不在一起 - 各端 manifest.json 中的“DCloud AppID”需保持一致（H5 端填
H5，小程序填对应平台 AppID，App 填原生应用包名或 AppID），这是uni-id区分客户端来源的依据 - 用户必须使用同一身份源登录：比如用微信小程序首次登录，后续用支付宝小程序登录时，需确保支付宝账号已绑定同一手机号（或通过手机号关联），否则
uni-id默认不会合并——它只按凭证匹配，不主动做手机号对齐
常见错误现象与排查点
典型问题包括：用户在微信小程序登录后，切换到 H5 端又提示“未登录”、订单归属错乱、消息收不到。原因往往不是代码写错，而是：
-
uni-id-co云函数未部署，或部署后未在uniCloud控制台启用（需手动点击“启用”） - H5 端未配置
web类型 provider，导致uni.login({provider: 'web'})报错或 fallback 到匿名登录 - App 端未在 manifest.json 的“Android 包名”/“iOS Bundle ID”字段填写正确值，导致
uni-id识别为未知客户端，拒绝绑定 - 测试时用了两个微信账号分别登录小程序和 H5，误以为是“同一用户”——其实
uni-id不会跨账号合并，必须用同一授权主体
真正容易被忽略的是：跨端统一认证依赖服务端的绑定逻辑执行成功，而这个过程完全黑盒——你得进 uniCloud 数据库看 opendb-uni-id-users 表里 uni_id 字段是否一致，以及 oauth 子集合里各平台凭证是否都指向同一个 _id。
