跳到主要内容

SDK（manager-node）错误码

@cloudbase/manager-node 在部署、构建、数据库迁移等流程中抛出的错误码。其 source 为 manager-node。

共 48 个错误码。每个错误码下的条目即失败时展示给你的文案（占位符 … 表示随场景变化的具体值）。

API_ERROR​

  • API_ERROR
  • […] 获取函数代码下载链接失败：…
  • […] 调用失败：…

BUILD_ARG_INVALID​

  • 构建参数 … 可能包含敏感信息；cloud 构建禁止通过 buildArgs 传递密钥
  • 构建参数 … 的值必须是无 NUL 字符的字符串
  • 构建参数名不合法：…

BUILD_CONTEXT_INVALID​

  • 打包云端构建上下文失败：…
  • 构建上下文目录不存在或不是目录：…
  • 获取 COS 上传凭证失败：返回缺少 UploadUrl 或 UnixTimestamp

BUILD_DOCKERFILE_INVALID​

  • Dockerfile 路径不合法，需为构建上下文内的安全相对路径

BUILD_FAILED​

  • 本地构建失败：在 … 执行「…」失败。 …

BUILD_PLATFORM_INVALID​

  • 当前仅支持构建 … 镜像

BUILD_REPOSITORY_INVALID​

  • build.namespace 与 build.repository 中的命名空间不一致
  • cloud 策略的企业版 TCR 需要明确仓库域名：请将 build.repository 配置为
  • cloud 策略缺少 TCR 命名空间，请配置 build.namespace 或在完整 repository 中声明

BUILD_TAG_INVALID​

  • cloud 策略不支持自定义 build.tag，请移除该字段并使用平台生成的 CLOUDBASE_VERSION_NAME
  • 镜像 tag 含非法字符：…

CHECK_REPORT_INCONSISTENT​

  • 部署前检查未通过，但未给出具体失败项，请重试或用 --debug 查看完整报告
  • 部署配置校验未通过，但未给出具体失败项，请重试或用 --debug 查看完整报告

CLOUD_BUILD_DOCKERFILE_MISSING​

  • Dockerfile 不存在或不是普通文件：…

CLOUD_BUILD_FAILED​

  • 查询构建状态连续失败 … 次：…

CLOUD_BUILD_TIMEOUT​

  • 云端构建超时（超过 … 分钟仍未完成）

CLOUD_REGISTRY_CREDENTIAL_INVALID​

  • 个人版 TCR 凭证不合法：TCB_TCR_USERNAME 需为腾讯云账号 ID，

CLOUD_REGISTRY_CREDENTIAL_MISSING​

  • 个人版 TCR 云端构建缺少 imageConfig.build.registryCredential；请在 cloudbaserc 中显式声明
  • 个人版 TCR 构建缺少推送凭证。
  • 企业版 TCR 云端构建缺少临时登录凭证，请确认当前身份具备 CreateInstanceToken 权限

CLOUD_UPLOAD_FAILED​

  • 上传源码到 COS 失败：… ……

CONFIG_ERROR​

  • CONFIG_ERROR

CONFIG_INVALID​

  • 部署配置必须是对象

DEST_EXISTS​

  • 目标文件已存在: …

FILE_READ_ERROR​

  • FILE_READ_ERROR

FILE_SIZE_LIMIT_EXCEEDED​

  • 文件大小超过 100MB

FUNCTION_RECREATE_REQUIRED​

  • 函数 … 存在无法原地更新的变更：

HOSTING_DEPLOY_FAILED​

  • [uploadFiles] 串行上传仍失败 (… 个):
  • [uploadFiles] 串行重试后仍失败 (… 个):

IMAGE_REGISTRY_ID_INVALID​

  • cloud 策略的企业版 TCR build.registryId 已声明但解析结果为空；若使用 {{env.*}}，请确认环境变量已赋值，当前没有企业版实例时请改用 imageType=personal

IMAGE_REGISTRY_ID_MISSING​

  • cloud 策略的企业版 TCR 未配置 build.registryId；如果当前没有企业版实例，请改用 imageType=personal
  • 企业版 TCR local 构建缺少 registryId。
  • 企业版镜像缺少 TCR 实例 ID（registryId），无法生成镜像部署物。

IMAGE_TAG_LATEST_FORBIDDEN​

  • 镜像 tag 禁止使用 latest，请使用不可变 tag

IMAGE_TYPE_INVALID​

  • cloud 策略的 personal 镜像不能配置 build.registryId；请移除该字段或改用 enterprise

INVALID_OPERATION​

  • 当前环境的静态托管使用共享桶（ExternalStorage），静态网站配置作用于整个共享桶，由平台统一管理，不支持修改
  • 您还没有开启静态网站服务，请先到云开发控制台开启静态网站服务！
  • 静态网站文件不为空，无法销毁！

INVALID_PARAM​

  • INVALID_PARAM

LOCAL_BUILD_CONTEXT_MISSING​

  • 构建上下文目录不存在：…

LOCAL_BUILD_DOCKERFILE_MISSING​

  • Dockerfile 不存在：…

LOCAL_BUILD_FAILED​

  • 镜像构建失败，请检查 Dockerfile、构建上下文和本地 Docker 输出。

LOCAL_BUILD_REPOSITORY_MISSING​

  • local 策略的目标镜像地址缺少仓库域名
  • local 策略缺少目标镜像仓库地址 imageConfig.build.repository

LOCAL_PUSH_FAILED​

  • 镜像推送鉴权失败，请确认镜像仓库登录凭证有效，并且当前身份具备目标仓库写权限。

MISSING_CREDENTIAL​

  • MISSING_CREDENTIAL

NETWORK_ERROR​

  • NETWORK_ERROR
  • 数据库迁移任务状态查询超时（…s），TaskId: …，最后错误：…
  • 数据库迁移任务超时（…s），TaskId: …，当前状态: …/…

NOT_FOUND​

  • NOT_FOUND

PATTERN_DANGEROUS​

  • 正则表达式包含潜在的危险模式（嵌套量词），可能导致性能问题

PATTERN_SYNTAX_ERROR​

  • 正则表达式语法错误: …

PATTERN_TOO_LONG​

  • 正则表达式过长，最大允许 … 字符

SOURCE_EMPTY​

  • 源目录为空: …

SOURCE_NOT_FOUND​

  • 源文件不存在: …
  • 源目录不存在: …

STORAGE_BATCH_DELETE_PARTIAL_FAILED​

  • 部分删除文件失败：…

TCR_DOCKER_LOGIN_FAILED​

  • 镜像仓库 Docker 登录失败，请检查登录凭证、仓库地址和访问权限。

TCR_INSTANCE_DISCOVERY_FAILED​

  • 查询企业版 TCR 实例失败，请确认当前身份具备 DescribeInstances 权限。

TCR_NAMESPACE_CREATE_FAILED​

  • 创建企业版 TCR 命名空间 … 失败。

TCR_NAMESPACE_QUERY_FAILED​

  • 查询企业版 TCR 命名空间 … 失败。

TCR_REGION_MISSING​

  • 企业版 TCR 自动发现需要明确部署地域，请在环境配置中设置 region。

TCR_TOKEN_CREATE_FAILED​

  • 获取企业版 TCR 临时登录凭证失败，请确认当前身份具备 CreateInstanceToken 权限。