不存在 hub deploy 命令 | 项目未依赖 @nocobase/hub-cli，执行 pnpm add -D @nocobase/hub-cli；该命令仅在源码项目中可用 |
CLI 报告 NO_REMOTE | 尚未配置远程，通过 hub remote add <名称> <Hub 地址>/apps/<应用 ID> 添加，并提交 .nocobase/hub.json |
CLI 报告 NOT_LOGGED_IN | 本机未保存该远程的密钥，执行 hub auth login；在 CI 中将密钥变量通过管道传给 hub auth login --with-token |
CLI 报告 BUILD_FAILED | 错误之前输出的构建日志说明了原因，在项目中修复后重新部署 |
CLI 报告 BUILD_TARGET_MISMATCH | 通过 --no-build 或 --file 指定的部署包是为其他平台构建的；去掉这两个参数，由 hub deploy 针对 Hub 构建 |
CLI 报告 BUILD_TARGET_UNAVAILABLE | Hub 的 App Host 未响应，Hub 无法报告其平台；在 Hub 中检查 Host 状态，或按管理界面部署的方式针对 Hub 环境构建，再通过 --file 部署该部署包 |
| CLI 找不到部署包 | 只有 --no-build 和 --file 读取已有部署包；去掉这两个参数由 hub deploy 构建，或通过 --file 指定正确路径 |
| 上传返回 413 | 反向代理的请求大小限制，在 Nginx 中增加 client_max_body_size 260m;：管理界面上传整个归档（最大 256 MiB），CLI 按 8 MiB 分段上传（归档最大 2 GiB） |
| 返回 401 或 403 | API Key 无效、未绑定该应用、缺少上传或部署权限，或创建者已失去相应权限；通过 hub auth status 检查，再用 hub auth login 保存正确的密钥 |
| 返回 409 | 同一幂等键提交了不同的请求；原样重试原请求，或为新请求使用新的 --idempotency-key |
| CLI 退出码为 3 | 结果未确认。先查看 Hub 的部署记录，再使用相同的 --idempotency-key 重试 |
| 部署成功但应用无法启动 | 通常为通过管理界面上传的部署包构建目标不匹配，见上文原生模块一行 |
提交 --config 后原有字段丢失 | --config 整份替换配置，需要提交完整配置 |
