跳到主要内容

CLI 本地错误码

tcb 命令在本地校验、构建、部署流程中抛出的错误码。其 source 为 cli，与云 API 返回的平台码分属不同来源层 —— 同一个码名（如 INVALID_PARAM）在不同来源层含义不同，请以 (code, source) 二元组定位。

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

API_BLOCKED​

  • 该操作被禁止：{{reason}}

API_ERROR​

  • Agent 创建失败：{{msg}}
  • Agent 更新失败：{{msg}}
  • Git 模板下载失败: {{error}}

AUTH_FAILED​

  • 当前登录方式为永久密钥（tcb login --key），tcb secrets get 仅支持临时密钥输出。
  • 无有效身份信息，请使用 cloudbase login 登录
  • 未找到有效的凭证，请先执行 tcb login 完成登录

BIND_FAILED​

  • 绑定失败：{{error}}

BUILD_FAILED​

  • [{{name}}] 构建失败：在 {{root}} 执行「{{cmd}}」失败 {{detail}}

BUILD_OUTPUT_NOT_FOUND​

  • [{{name}}] 未找到有效构建产物：{{dir}}（目录不存在或为空） hosting 声明式部署不再自动执行本地构建，请先执行 {{cmd}} 完成构建后再执行 tcb deploy

BUILD_TIMEOUT​

  • 构建超时

CACHE_PURGE_NOT_SUPPORTED​

  • 域名 [{{domain}}] 的接入方式为 {{accessType}}，未接入 CDN 或 EdgeOne，不支持缓存刷新

CERT_NOT_FOUND​

  • 未找到域名 [{{domain}}] 相关的可用 SSL 证书

CLOUD_API_ERROR​

  • 云托管部署失败
  • 云托管部署已被取消
  • 套餐变更失败：{{message}}。建议检查账户状态或运行 {{cmd}} 重新登录后重试

CONFIG_CONFLICT​

  • 代码部署模式下不应该配置 imageConfig
  • 镜像部署模式下必须配置 imageConfig

CONFIG_NOT_FOUND​

  • AI 配置未找到，请运行 tcb ai --setup 进行配置
  • 未找到 integrations 配置，请在 cloudbaserc.json 中配置 integrations 字段

DELETE_FAILED​

  • 集成实例删除失败

DELETE_FILE_FAILED​

  • 该错误码由本地流程判定失败时抛出，具体原因见报错文案。

DEPENDENCY_NOT_INSTALLED​

  • [{{name}}] 未检测到 node_modules。构建前请先在 {{root}} 目录自行安装依赖（如 npm install），构建过程不会代为安装依赖

DEPLOY_FAILED​

  • 部署失败: {{message}}

DEPLOY_INPUT_MISSING​

  • 部署参数不完整，请补充：{{fields}}

DEPLOY_PARTIAL_FAILED​

  • 部分文件上传失败
  • 部分文件上传失败，进程退出

DOMAIN_NOT_FOUND​

  • 未在环境中找到域名 [{{domain}}]，无法自动识别缓存类型

DOWNLOAD_FILE_FAILED​

  • 该错误码由本地流程判定失败时抛出，具体原因见报错文案。

DRY_RUN_FAILED​

  • 该错误码由本地流程判定失败时抛出，具体原因见报错文案。

EMPTY_BODY​

  • 服务端未返回对象元信息（status={{status}}）
  • 服务端未返回文件内容（status={{status}}）

ENV_ID_REQUIRED​

  • 未识别到有效的环境 Id，请通过以下任意方式指定：

ENV_NOT_FOUND​

  • 未找到环境
  • 环境 {{envId}} 在 {{region}} 地域不存在或无权限访问

ENV_NOT_PG​

  • 当前环境不是 PostgreSQL 环境（envId: {{envId}}）

FETCH_TEMPLATE_FAILED​

  • 拉取集成类型模板失败：{{error}}

FILE_EXISTS​

  • 目标文件已存在: {{path}}
  • 目标文件已存在：{{path}}

FILE_NOT_FOUND​

  • {{type}}不存在: {{path}}
  • 存储文件夹不存在！
  • 文件不存在: {{paths}}

FILE_READ_ERROR​

  • 下载 URL 中不包含有效文件名

FILE_READ_FAILED​

  • 无法读取文件 {{path}}：{{error}}

FLAT_CMD_NOT_AVAILABLE_IN_PG​

  • …（envId: …）

FUNCTION_NOT_FOUND​

  • 云函数 [{{name}}] 在当前环境不存在，无法绑定

GET_ENV_DETAIL_FAILED​

  • 获取环境详情失败：{{message}}

GET_TEMPLATE_FAILED​

  • 获取集成模板失败，无法确定资源类型字段: {{error}}

HOSTING_DEPLOY_FAILED​

  • 静态文件上传失败: {{message}}

HOSTING_NOT_ENABLED​

  • 静态网站服务未开通

INTEGRATION_AES_KEY_FETCH_FAILED​

  • 获取集成加解密密钥失败：七彩石返回异常（ErrorCode={{errorCode}}）。请确认当前环境已开通集成中心能力
  • 获取集成加解密密钥失败：七彩石配置拉取请求异常，请检查网络连接或代理设置

INTEGRATION_AES_KEY_NOT_FOUND​

  • 获取集成加解密密钥失败：七彩石配置中缺少 {{field}} 字段

INTEGRATION_AES_KEY_PARSE_FAILED​

  • 获取集成加解密密钥失败：七彩石配置内容解析失败

INVALID_CONFIG​

  • 函数配置不符合 v2.1 Schema： {{errors}}
  • 触发器配置不能为空

INVALID_ENUM​

  • 无效的 status：{{status}}，仅支持：ACTIVE, BLOCKED
  • 无效的 type：{{type}}，仅支持：internalUser, externalUser

INVALID_JSON​

  • --body 不是合法的 JSON 字符串：{{body}}

INVALID_METRIC_NAME​

  • 无效的指标名：{{names}}

INVALID_MIGRATION_NAME​

  • migration 名称非法：{{name}}

INVALID_OPERATION​

  • 您还没有开启静态网站服务，请先到云开发控制台开启静态网站服务！ {{link}}
  • 该环境还未开通静态托管，无法进行此操作！请先到云开发控制台开通 {{link}}
  • 静态托管资源初始化失败，请到云开发控制台查看

INVALID_PARAM​

  • --copy-metadata 参数非法: {{value}}
  • --custom-cname 参数仅在 --access-type 为 CUSTOM 时可用
  • --cwd 参数必须指向一个目录: {{path}}

INVALID_PARAMS​

  • --name 参数为必填项
  • --runtime 参数为必填项
  • 代码目录不存在：{{path}}

LIST_FILE_FAILED​

  • 该错误码由本地流程判定失败时抛出，具体原因见报错文案。

LOG_SERVICE_NOT_ENABLED​

  • 日志服务未开通，无法执行日志查询。请开通日志服务后重试。

MIGRATION_TASK_FAILED​

  • migration up 任务执行失败: {{reason}}

MIGRATION_TASK_TIMEOUT​

  • migration up 任务等待超时（{{minutes}} 分钟）

MISSING_ARGS​

  • 请指定服务名称和 Action，例：tcb api tcb DescribeBillingInfo

MISSING_ARGUMENT​

  • 缺少参数：请指定要删除的文件路径
  • 请指定搜索模式
  • 请指定源路径和目标路径

MISSING_PARAM​

  • --json 模式下需要配合 --yes 跳过确认
  • CSV 格式导出必须通过 --fields 指定字段
  • 云函数名称不能为空

NETWORK_ERROR​

  • [{{functionName}}] 等待函数更新超时

NOT_FOUND​

  • 云函数 [{{name}}] 不存在，请先使用 tcb fn deploy {{name}} 部署函数
  • 云函数 [{{name}}] 的版本 [{{version}}] 不存在！ 可用版本：{{available}}
  • 集成 [{{keyId}}] 不存在

OPERATION_CANCELLED​

  • 操作终止！

PG_QUERY_FAILED​

  • 执行 PostgreSQL 查询失败: {{msg}}

REQUEST_TIMEOUT​

  • 等待云托管部署超时，任务可能仍在后台执行
  • 等待服务{{url}}就绪超时

RESOURCE_NOT_FOUND​

  • Agent 不存在：{{agentId}}
  • [{{name}}] 函数不存在
  • 以下路由不存在，无法更新: {{paths}}

TASK_FAILED​

  • 缓存刷新任务状态: {{status}}

TASK_NOT_FOUND​

  • 未找到刷新任务 {{taskId}}

UNSUPPORTED_PARAM​

  • CLS 检索不支持 offset 偏移
  • CLS 检索仅支持按时间升降序，不支持按字段排序

USER_CANCEL​

  • 操作已取消
  • 操作终止！

USER_CANCELLED​

  • 操作终止！

WAIT_TIMEOUT​

  • 等待刷新任务超时（上限 10 分钟），可稍后使用 tcb domains cache task {{taskId}} -d {{domain}} 查询进度