uni-app 调用 uniCloud.callFunction 报 undefined 或“找不到”云函数，90% 是因云空间未创建或项目未关联；需检查 uniCloud 文件夹是否存在、在 DCloud 控制台确认服务空间「已就绪」、HBuilderX 中右键项目关联云空间、部署云函数时右键文件夹上传、前端 name 与文件夹名严格一致、H5 需开启「使用本地云函数」、小程序真机调试前切换对应服务空间；数据库操作必须封装在云函数中，权限需在控制台手动配置，字段名避免驼峰；使用腾讯云/阿里云原生 SDK 须安装 @cloudbase/uni-app-adapter 并调用 useAdapter。
uni-app 调用 unicloud.callfunction 报 undefined、云函数“找不到”、数据库查不到数据——90% 不是代码写错了，而是环境没对齐。必须先完成云空间创建和项目关联，否则所有后续操作都无效。
uniCloud.init 报错或 callFunction 是 undefined
这是最典型的“环境缺失”信号，不是 SDK 未加载，而是项目根本没接入 uniCloud 生态。
- 检查项目根目录下是否存在
uniCloud文件夹：没有 → 说明未关联云空间，HBuilderX 不会自动生成 - 打开 DCloud 控制台（https://www.php.cn/link/104c6f99020b85465ae361a92d09a8d1），确认已创建状态为「已就绪」的服务空间
- HBuilderX 中右键项目 →「uniCloud」→「关联云空间」，选中刚创建的空间；此时才会生成
uniCloud/cloudfunctions和uniCloud/database -
uniCloud.init不是启动命令，它只做连接，且必须传spaceId和provider（如"aliyun"），这两个值来自控制台服务空间详情页
云函数部署后前端调用仍提示 function not found
部署动作没真正发生，或者调用参数与部署结构不匹配。
- 云函数必须右键其所在文件夹（如
uniCloud/cloudfunctions/hello）→「上传部署」，仅保存index.js不生效 - 前端
name参数必须与云函数文件夹名**完全一致**，包括大小写：hello≠Hello≠hello-world - H5 端调试时，若未开启「H5 使用本地云函数」（
manifest.json→ H5 配置 → 勾选），请求会走浏览器 CORS 校验而被拦截，表现为网络错误而非函数不存在 - 微信小程序真机调试前，确保当前 HBuilderX 已切换到对应服务空间：右键
uniCloud目录 →「切换服务空间」
数据库查询返回空数组或 permission denied
uni-app 前端禁止直连数据库，所有 DB 操作必须封装在云函数里；即使能调用 uniCloud.database()，也因权限未开而失败。
- 前端不能写
uniCloud.database().collection('users').get()—— 这行代码在编译期不会报错，但运行时返回空或 403 - 权限配置不在代码中，而在 UniCloud 控制台：进入服务空间 →「数据库」→ 点击表名 →「表结构」→「权限」标签页 → 将
"read": false改为"read": true或更细粒度规则（如"read": {"auth": "user"}） - 字段名避免驼峰，如
nickName在部分旧版客户端解析异常；推荐nick_name或nickname - 云函数内执行 DB 操作必须加
.get()、.add()等终态方法才真正触发，否则只是构造查询对象
想用腾讯云/阿里云原生 SDK 怎么办
直接 npm install @cloudbase/js-sdk 会报 uni.request is not a function，因为原生 SDK 依赖 fetch/XMLHttpRequest，而 uni-app 统一走 uni.request。
- 不要 patch 或重写 SDK，改用官方适配包：
npm install @cloudbase/uni-app-adapter - 初始化时需传入适配器：
const app = cloudbase.init({ ... }); app.useAdapter(uniAppAdapter); - 该适配器只补全网络层契约，其余 API（如
app.auth().loginWithWechat）可照常使用 - 注意：此方案适用于需要复用云厂商高级能力（如云调用、登录态透传）的场景，日常 CRUD 用
uniCloud.callFunction+ 云函数更轻量
最容易卡住的地方，永远不在代码逻辑里，而在服务空间是否创建、是否关联、是否部署、权限是否开放这四步上。每一步都得去控制台或 HBuilderX 里点一次确认，少一次，后面全白忙。
