uni-id云函数未生效的主因是未正确上传或配置：需右键上传uni-id-co云函数、检查manifest.json指向正确服务空间、删除node_modules后重传、确认config.json含微信小程序配置、code须实时获取且域名合法。
uni-id 云函数没生效？先确认 uniCloud 服务空间已绑定且上传成功
很多开发者卡在“调用 uniIdCo.loginByWeixin 返回空或报错”，根本原因常是云函数压根没部署上去。HBuilderX 的“上传所有 DB Schema”只是同步数据库结构，不等于云函数已发布——必须右键 uniCloud/cloudfunctions/uni-id-co 文件夹，选择「上传云函数」，且确保右下角状态栏显示“上传成功”。如果项目用了多个服务空间（如阿里云、腾讯云），还要检查 manifest.json 中的 uniCloud 节点是否指向当前激活的空间。
- 上传前务必删掉
cloudfunctions/uni-id-co/node_modules（HBuilderX 会自动重装依赖） - 上传后打开云开发控制台，在「云函数」列表里确认
uni-id-co状态为“运行中” - 若控制台提示“依赖缺失”，说明
package.json里没正确声明"uni-id": "^2.0.0"（注意版本号需与插件市场下载的匹配）
uniIdCo.loginByWeixin 报 403 或 token is invalid？检查微信登录链路断在哪一环
这个错误表面是 token 问题，实际多因微信侧未打通：要么小程序未配置 AppID，要么云函数内未传入有效 code，要么 uni-config-center/uni-id/config.json 缺少 weixin 配置块。特别注意，uni-id-co 默认只支持微信开放平台授权（需绑定公众号），若仅用小程序，必须手动在 config.json 里补全：
{
"weixin": {
"mp": {
"appid": "你的小程序 AppID",
"appsecret": "你的小程序 AppSecret"
}
}
}
-
uni.login({ provider: 'weixin' })必须在真机或微信开发者工具中调用，模拟器返回的 code 无效 - 调用
uniIdCo.loginByWeixin时，code字段必须来自uni.login成功回调，不能复用旧 code（5分钟过期） - 如果小程序未在「开发管理 → 接口安全」中配置合法域名，云函数请求微信接口会失败，此时控制台日志会出现
request:fail ssl hand shake error
注册/登录逻辑写在 App.vue 里？别这么干，会破坏路由守卫和状态管理
官方示例把 uniIdCo.loginByWeixin 放在 onLaunch 里，看似方便，但会导致两个严重问题：一是冷启动时用户还没进首页就弹微信授权框，体验割裂；二是登录态无法与 Vue Router 的 beforeEach 守卫联动，比如“未登录跳登录页”逻辑失效。真实项目应把登录拆成两步：
- App.vue 中只做 token 检查：
uni.getStorageSync('uni_id_token')存在则静默续期，不存在则不干预 - 首次进入首页（如
pages/index/index.vue）时，用onShow触发登录流程，并配合uni.showModal引导用户授权 - 登录成功后，把
token和uid存入 Pinia 或uni.setStorageSync，避免每次刷新都重登
数据库表字段名被自动转小写？uni-id 的 schema 严格区分大小写
当你在云数据库里查不到用户数据，或者 uniID.register 报 field not found，大概率是 DB Schema 同步时字段名大小写不一致。uni-id 的默认 schema（database/uni-id-users.schema.json）里字段全是小写（如 username、password），但如果你在代码里写了 UserName 或 user_name，云数据库不会自动映射——它按字面量建索引，大小写不同就是不同字段。
- 上传 DB Schema 前，务必打开
database/uni-id-users.schema.json，确认所有field名与你代码中传参完全一致 - 自定义字段（如
avatar）也要加到 schema 的custom节点里，否则插入时被过滤 - 上线前用云开发控制台手动执行一条
db.collection('uni-id-users').add({ username: 'test', password: '123' })，验证字段是否写入成功
真正的坑不在配置步骤，而在“以为配完了就万事大吉”——比如微信 AppID 写错一个字符，云函数上传时没选对环境，或者 schema 里漏了 mobile 字段却在登录时传了手机号。这些细节不报明显错误，只让功能静默失效。
