uniCloud 云开发空间需完成实名认证、创建服务空间、关联项目三步，缺一不可；实名认证是硬门槛，阿里云/支付宝云提供免费开发者版，腾讯云按量付费；配置 spaceId 和 clientSecret 必须严格匹配且从控制台复制。
uniCloud 云开发空间不是“开通”就能直接用的，必须完成实名认证 + 创建服务空间 + 关联项目三步，缺一不可。没走完流程时右键 uniCloud 显示“未关联服务空间”，不是配置问题，是流程卡在前置环节。
实名认证是硬门槛，不完成就无法创建服务空间
阿里云、支付宝云、腾讯云三家都要求账号完成**企业或个人实名认证**，且认证信息需与 DCloud 开发者中心一致。常见卡点：
- 腾讯云提示“身份证下已创建过多账户”：需登录腾讯云官网注销闲置子账户，否则无法通过审核
- 支付宝云首次使用必须扫码授权：HBuilderX 弹窗后要打开支付宝 App 扫码确认，不能只点“允许”就以为完成
- 认证审核通常需 1–3 个工作日，期间无法创建任何服务空间，别反复重试
创建服务空间时选错厂商，后续无法切换
一个 uni-app 项目只能绑定一个服务空间，而服务空间绑定的是具体云厂商（阿里云 / 支付宝云 / 腾讯云）。关键事实：
- 阿里云、支付宝云提供「开发者版免费空间」，仅限测试，资源上限低（如数据库容量 1GB、云函数调用次数有限）
- 腾讯云无免费空间，创建即计费，控制台默认显示“按量付费”选项，容易误点
- 服务空间创建后，
spaceId和clientSecret会固定生成，项目里uniCloud配置必须严格匹配，大小写、短横线都不能错
关联项目前，必须确保 HBuilderX 已登录且项目启用 uniCloud
新建项目时勾选「启用 uniCloud」是必要操作；如果项目已存在，仅右键「创建云开发环境」是无效的。正确路径：
- 项目根目录下必须存在
uniCloud文件夹，且内部有cloudfunctions或database子目录 - HBuilderX 右上角账号头像要显示已登录状态，未登录时右键
uniCloud→「关联服务空间」会灰掉 - 关联操作必须在项目已加载完成后再执行，刚新建完项目就右键，可能因索引未就绪导致列表为空
上传部署失败，大概率是 spaceId 或 clientSecret 配置错误
上传云函数或初始化数据库前，manifest.json 中的 uniCloud 节点必须填对：
{
"name": "myapp",
"uniCloud": {
"provider": "aliyun",
"spaceId": "your-space-id-here",
"clientSecret": "your-client-secret-here"
}
}
其中 spaceId 和 clientSecret 必须从 uniCloud Web 控制台对应服务空间的「概览」页复制，不能从短信/邮件截图里手打，也不能从旧项目配置里拷贝——哪怕只是多一个空格，上传就会报 401 Unauthorized 错误。
整个过程最易被忽略的是：服务空间创建完成后，需要手动回到 HBuilderX 刷新 uniCloud 右键菜单，而不是等它自动更新。创建可能耗时几十秒，但 UI 不提示，很多人以为失败就重复点击，结果生成了多个同名空间却没注意到。
