# 错误码

> 本页列出浏览器 RPA 节点记录（`nodes.list` / `GET /runs/{id}/nodes` 的 `error`）、运行结果（`run.error`）和 Local API 请求中可能出现的错误码。
通过 Local API 读取 `docs/api/error-codes.md` 时按请求语言返回对应版本（规则与 `message` 相同：`Accept-Language` 优先，未带时用客户端界面语言，不支持的语言返回 en-US）；读取固定语言请使用 `error-codes.<语言>.md`，中文为 `error-codes.zh-CN.md`。


## 错误对象

```json
{"code": "ELEMENT_NOT_FOUND", "message": "没有找到匹配的元素，请检查选择器是否正确、页面是否已加载完成", "retryable": false, "details": {"phase": "selector", "matchedCount": 0}}
```

- `code`：稳定错误码，恢复和分支逻辑按它判断。
- `message`：给人看的提示，与客户端界面对同一错误显示的句子相同，按请求头 `Accept-Language` 的语言返回（未带时为客户端界面语言）；文字随版本和语言变化，程序请按 `code` 与 `details` 判断，不要解析 `message`。下表「说明」列是面向开发者的错误码说明，不是接口返回的 `message`。
- `details`：可选的结构化上下文；没有可用信息时为 `null`。只会出现下表字段。除 `cause` 外不包含原始异常文本、URL、选择器、本地路径、页面内容或私密输入；`cause` 只出现在无法识别具体原因的兜底错误 `ATOM_FAILED` / `CONTROL_FAILED`、浏览器拒绝指令的 `CDP_ERROR` 和脚本抛出异常的 `SCRIPT_FAILED` 上，为原始原因文本（单行，最多 300 字符），不做内容替换。


| 字段 | 类型 | 含义 |
|  --- | --- | --- |
| field | string | 出错的节点输入字段，如 `selector`、`exception.retryTimes`、`fields[0].key` |
| reason | string | `required` 必填缺失、`type` 类型错误、`range` 超出范围、`enum` 不在可选值内、`format` 格式错误、`conflict` 字段冲突、`limit` 超出上限、`timeout` 超时、`cancelled` 被取消、`unknown` 未知字段或取值、`duplicate` 重复、`empty` 列表或内容为空 |
| expected | string | 期望类型：string / number / integer / boolean / object / array / null |
| min / max / limit | number | 范围下限、上限或数量/字节/毫秒限制 |
| httpStatus | number | HTTP 状态码 |
| netError | string | Chromium 网络错误，如 `ERR_NAME_NOT_RESOLVED`、`ERR_CONNECTION_REFUSED`、`ERR_BLOCKED_BY_CLIENT` |
| systemCode | string | 系统错误码，如 `ENOENT`、`EROFS`、`ECONNREFUSED` |
| matchedCount | number | 实际匹配到的元素数量 |
| phase | string | 失败阶段：navigation / selector / script / download / upload / network / file / host / mail / output |
| errorName | string | 用户脚本抛出的标准异常类型：Error / TypeError / ReferenceError / SyntaxError / RangeError / EvalError / URIError / AggregateError |
| format | string | 期望格式：absolutePath 本机完整路径 / fileName 文件名 / url 网址 / json / regex 正则 / numericExpression 数值表达式 / cookie / a1Range 表格区域 / spreadsheetId / serviceAccountKey / hostname 主机名 / selector 选择器 / dateTime / fieldPath 字段路径 / identifier 标识符 |
| allowed | string[] | 允许的取值或文件扩展名（配置项取值，不含用户数据），如 `["append","overwrite"]`、`[".txt"]` |
| reference | string | 无法解析的模板引用，如 `node_3.data.title`、`parameters.keyword` |
| cause | string | 仅兜底错误 `ATOM_FAILED` / `CONTROL_FAILED`、`CDP_ERROR` 与 `SCRIPT_FAILED`：原始异常信息的单行摘要（去掉换行，最多 300 字符，原文展示、不做内容替换），用于定位未归类的失败或说明浏览器拒绝的原因（如 `Cannot navigate to invalid URL`）；`SCRIPT_FAILED` 为脚本自身的异常消息（如 `kw is not defined`） |
| causeName | string | 仅 `ATOM_FAILED` / `CONTROL_FAILED` / `CDP_ERROR`：原始异常类型名（1–64 个英文字母），如 `Error`、`ProtocolError` |
| upstreamCode | number | string | 仅 `RPA_HOST_REQUEST_FAILED`：客户端向云端请求环境数据时服务端返回的错误码；此时 `message` 为“RPA 运行失败：{服务端提示}”，服务端提示的语言跟随失败发生时客户端的界面语言，可能与请求语言不同。网络失败、超时等没有服务端错误码时不出现，`message` 为“RPA 运行失败：网络异常，请检查网络环境后重试” |


旧版本产生的记录 `details` 为 `null`；其 `message` 原为错误码本身，读取时按本表返回说明。

## 输入与配置

| code | 说明 |
|  --- | --- |
| INVALID_INPUT | 节点输入不合法；details.field 指出字段，details.reason 指出原因（必填、类型、范围、枚举或格式）。 |
| INVALID_SELECTOR | 选择器语法无效，请检查 CSS / XPath / 文本选择器。 |
| INVALID_REGEX | 正则表达式无效或超出长度限制。 |
| INVALID_REFERENCE | 元素/框架引用无效，必须引用本次运行中前序节点输出的 ElementRef 或 FrameRef。 |
| MISSING_VARIABLE | 引用的变量或节点输出不存在；details.reference 为无法解析的引用，details.field 为包含它的输入字段。 |
| VARIABLE_TYPE_MISMATCH | 值的类型不符合要求。 |
| LIMIT_EXCEEDED | 超出节点允许的数量上限。 |
| RPA_INVALID_NODE | 节点配置不合法；issues 中的 path 指出字段位置。 |


## 元素

| code | 说明 |
|  --- | --- |
| OPTION_NOT_FOUND | 下拉框中没有可选的目标选项（不存在、已禁用或与单选/多选不符）。 |
| ELEMENT_NOT_FOUND | 在等待时间内没有找到匹配的元素；检查选择器、序号和页面是否已加载。 |
| ELEMENT_NOT_VISIBLE | 元素存在但不可见或不可点击（被隐藏、尺寸为 0 或被遮挡）。 |
| ELEMENT_NOT_FOCUSABLE | 元素无法获得焦点。 |
| ELEMENT_NOT_EDITABLE | 元素不可编辑（只读、禁用或不是输入控件）。 |
| ELEMENT_TYPE_MISMATCH | 元素类型不符合节点要求，例如下拉选择节点的目标不是 select。 |
| FRAME_NOT_FOUND | 目标元素不是 iframe，或 iframe 内容不可访问。 |
| STALE_REFERENCE | 元素引用已失效（页面跳转或元素被移除），请重新获取元素。 |


## 页面与标签页

| code | 说明 |
|  --- | --- |
| TAB_NOT_FOUND | 没有符合条件的标签页。 |
| NO_ACTIVE_PAGE | 当前没有可操作的标签页。 |
| PAGE_CLOSED | 操作过程中页面或浏览器被关闭。 |
| PAGE_NAVIGATED | 操作过程中页面发生跳转或框架被移除，请在页面稳定后重试。 |
| CDP_ERROR | 浏览器拒绝了自动化指令；details.cause 为浏览器返回的错误摘要，如 Cannot navigate to invalid URL。 |
| CDP_NOT_READY | 浏览器调试连接尚未就绪。 |


## 导航

| code | 说明 |
|  --- | --- |
| NAVIGATION_FAILED | 浏览器无法打开该地址；details.netError 为 Chromium 网络错误（如 ERR_NAME_NOT_RESOLVED、ERR_CONNECTION_REFUSED）。 |


## 网络与外部请求

| code | 说明 |
|  --- | --- |
| HTTP_ERROR | HTTP 请求返回非成功状态；details.httpStatus 为状态码。 |
| NETWORK_REQUEST_FAILED | 网络请求失败（连接被拒绝、超时、DNS 或证书错误）；details.systemCode 为原因。 |
| NETWORK_DOWNLOAD_FAILED | 上传附件前下载网络文件失败；details 中的 httpStatus / netError / systemCode 说明原因。 |
| NETWORK_WAIT_TIMEOUT | 在等待时间内没有捕获到符合条件的网络请求或响应；details.matchedCount 为已捕获但仍无响应的请求数（0 表示没有匹配的请求）。 |
| LISTENER_NOT_FOUND | 没有正在运行的网络监听，或监听 ID 不存在；请先执行“开始网络监听”。 |
| RESPONSE_BODY_UNAVAILABLE | 响应正文不可读取（重定向、被拦截、已释放或为二进制）。 |
| RESPONSE_LIMIT | 响应内容超出大小限制。 |
| PROVIDER_CONNECTION_ERROR | 无法连接外部服务。 |
| PROVIDER_HTTP_ERROR | 外部服务返回错误状态。 |
| INVALID_PROVIDER_RESPONSE | 外部服务返回的数据格式无效。 |


## 脚本与输出

| code | 说明 |
|  --- | --- |
| OUTPUT_TYPE_MISMATCH | 返回值不符合设置的输出格式；details.expected 为期望类型。 |
| SCRIPT_FAILED | 用户脚本执行时抛出异常；details.errorName 为异常类型（如 TypeError、ReferenceError），details.cause 为异常消息摘要，如 kw is not defined。 |


## 文件

| code | 说明 |
|  --- | --- |
| ENOENT | 文件或目录不存在。 |
| EACCES | 没有访问该文件或目录的权限。 |
| EPERM | 系统不允许此文件操作。 |
| EROFS | 目标位置是只读文件系统。 |
| EEXIST | 目标文件已存在。 |
| ENOTDIR | 路径中的某一级不是目录。 |
| EISDIR | 目标是目录而不是文件。 |
| ENOSPC | 磁盘空间不足。 |
| EBUSY | 文件被占用。 |
| ENAMETOOLONG | 文件路径过长。 |
| EMFILE | 打开的文件过多。 |
| ENOTEMPTY | 目录不为空。 |
| EXDEV | 不能跨磁盘移动文件。 |
| FILE_IN_USE | 目标文件正被其他程序占用（例如 Excel 正在打开），关闭后重试；原文件未被修改。 |
| FILE_NOT_WRITABLE | 目标文件已存在且不可写（只读属性或权限限制），无法覆盖或写入；请修改名称或取消该文件的只读属性。 |
| FILE_LIMIT | 文件超出大小或数量限制。 |
| UPLOAD_FAILED | 浏览器没有接受所选文件。 |
| ARTIFACT_WRITE_FAILED | 运行结束时写出产物文件失败。 |


## 数据处理

| code | 说明 |
|  --- | --- |
| MISSING_FIELD | 指定的 JSON 字段路径不存在。 |
| OUTPUT_TOO_LARGE | 节点输出超过可记录的大小上限（50 MB）；details.limit 为上限字节数。 |
| SHEET_NO_DATA | 工作表中没有数据。 |
| SHEET_NOT_FOUND | 工作簿中没有指定名称的工作表；details.field 为工作表名称字段。 |
| SHEET_HEADER_INVALID | 表格第一行（表头）必须是互不重复的非空列名，且数据行列数不能超过表头。 |
| VALUE_CONVERSION_FAILED | 数据中的值无法按要求转换或比较；details.field 为对应字段，details.expected 为期望类型。 |
| INVALID_JSON_RESPONSE | 返回内容不是合法 JSON。 |


## 邮件

| code | 说明 |
|  --- | --- |
| MAIL_CONNECTION_FAILED | 无法连接或登录邮箱服务器，请检查主机、端口、TLS 和凭证。 |
| MAIL_TLS_MISMATCH | 邮箱服务器在连接后没有返回 IMAP 问候，或 TLS 握手被拒绝，通常是端口与 TLS 设置不匹配（例如 993 需启用 TLS）。 |
| MAIL_PROVIDER_UNSUPPORTED | 该邮箱服务不支持所选认证方式或文件夹（OAuth2 / 垃圾箱仅支持 Outlook）。 |
| MAIL_JUNK_FOLDER_UNAVAILABLE | 邮箱没有可访问的垃圾邮件文件夹。 |
| MAIL_MESSAGE_LIMIT | 邮件内容超出读取上限。 |
| MAIL_SEARCH_LIMIT | 匹配的邮件数量超出读取上限，请增加筛选条件。 |
| MAIL_SEARCH_FAILED | 邮箱服务器拒绝了搜索条件（NO/BAD），请调整筛选条件。 |
| MAIL_CREDENTIAL_STORE_ERROR | 读取或保存邮箱授权信息失败。 |


## 浏览器环境与客户端

| code | 说明 |
|  --- | --- |
| NO_BROWSER | 当前没有已连接的浏览器环境。 |
| NO_ACTIVE_ENVIRONMENT | 当前没有活动的浏览器环境（可能已被关闭），请先启动或切换环境。 |
| UNKNOWN_ENVIRONMENT | 环境不存在，或未被本次运行打开。 |
| INVALID_ENVIRONMENT | 环境信息无效或不是 Chromium 环境。 |
| ENVIRONMENT_CLOSED | 环境已关闭。 |
| ENVIRONMENT_STILL_RUNNING | 关闭后环境仍在运行，未能确认关闭。 |
| RPA_BROWSER_CORE_MISSING | 本机缺少该环境需要的浏览器内核；客户端会自动开始下载（可在更新中心查看进度），下载完成后重新运行。 |
| RPA_BROWSER_CORE_UPDATE_REQUIRED | 该环境需要更新浏览器内核；客户端会自动开始下载新版内核（可在更新中心查看进度），下载完成后重新运行。 |
| RPA_BROWSER_CORE_SYSTEM_UNSUPPORTED | 当前系统不支持该浏览器内核。 |
| RPA_BROWSER_CORE_OFFLINE | 浏览器内核已下线，请更换内核版本。 |
| RPA_BROWSER_CACHE_PATH_INVALID | 浏览器缓存目录无效。 |
| RPA_CLIENT_UPDATE_REQUIRED | 客户端版本过低，请更新后重试。 |
| RPA_BROWSER_NOT_READY | 浏览器已启动但调试连接未就绪。 |
| RPA_BROWSER_START_FAILED | 浏览器环境启动失败（含内置插件环境检查未通过），请在环境列表中手动打开该环境排查。 |
| RPA_BROWSER_CONNECT_FAILED | 浏览器环境已打开，但无法建立自动化连接，请关闭该环境后重试。 |
| RPA_BROWSER_CLOSE_TIMEOUT | 等待浏览器关闭超时。 |
| RPA_HEADLESS_CORE_UNSUPPORTED | 无头浏览器仅支持 130 及以上版本的浏览器内核。 |
| RPA_ENVIRONMENT_NOT_FOUND | 找不到指定的环境（ID 或序号不存在）。 |
| RPA_ENVIRONMENT_AMBIGUOUS | 指定条件匹配到多个环境，请使用环境 ID。 |
| RPA_ENVIRONMENT_ID_REQUIRED | 缺少环境 ID。 |
| RPA_ENVIRONMENT_ID_MISMATCH | 客户端返回的环境与请求不一致。 |
| RPA_UNSAFE_ENVIRONMENT_ID | 环境 ID 超出安全整数范围，请以字符串传入。 |
| RPA_ENVIRONMENT_OUTSIDE_TASK | 该环境不在本次运行允许的范围内。 |
| RPA_ENVIRONMENT_STATUS_UNAVAILABLE | 无法读取环境状态。 |
| RPA_CHROMIUM_ENVIRONMENT_REQUIRED | 只支持 Chromium 浏览器环境。 |
| RPA_E2E_ENVIRONMENT_UNSUPPORTED | 端对端加密环境不支持浏览器 RPA。 |
| RPA_ENVIRONMENT_LOCKED | 环境正被其他成员使用（安全锁），暂时不能打开。 |
| RPA_ENVIRONMENT_TRANSFERRING | 环境正在转移中，暂时不能打开。 |
| RPA_ENVIRONMENT_PROXY_DELETED | 环境绑定的代理已删除，无法启动。请更新环境内的代理信息后重试。 |
| RPA_ENVIRONMENT_QUOTA_EXCEEDED | 套餐可用环境数量不足，不能打开该环境。 |
| RPA_ENVIRONMENT_DAILY_OPEN_LIMIT | 已达到今日环境打开次数上限。 |
| RPA_TAG_ID_UNKNOWN_OR_AMBIGUOUS | 标签 ID 不存在或不唯一；只能使用团队中已有的标签。 |
| RPA_TAG_CATALOG_INVALID | 读取团队标签列表失败。 |
| RPA_TAG_READBACK_INVALID | 标签已提交但读回结果无效。 |
| RPA_TAG_UPDATE_NOT_CONFIRMED | 标签更新未能在读回中确认。 |
| RPA_REMARK_READBACK_INVALID | 备注已提交但读回结果无效。 |


## 流程控制

| code | 说明 |
|  --- | --- |
| CONTROL_RUNTIME_REQUIRED | 控制节点只能在流程中执行。 |
| CONTROL_FAILED | 控制节点执行失败。 |
| BREAK_OUTSIDE_LOOP | “退出循环”不在循环内。 |
| ITERATION_LIMIT | 循环次数超出上限。 |
| STEP_LIMIT | 流程执行步数超出上限。 |
| CALL_DEPTH_LIMIT | 子流程嵌套层数超出上限。 |
| WORKFLOW_RECURSION | 子流程不能递归调用自身。 |
| WORKFLOW_NOT_FOUND | 找不到引用的子流程版本。 |
| WORKFLOW_REPOSITORY_REQUIRED | 子流程依赖未提供。 |
| WORKFLOW_FAILED | 子流程执行失败。 |
| NODE_FAILED | 节点执行失败。 |
| END_FAILED | 流程以失败状态结束。 |
| NODE_REMOVED | 该节点已下线，请从流程中移除。 |
| UNKNOWN_NODE | 未知节点类型。 |
| UNSUPPORTED_NODE | 当前版本不支持该节点。 |
| RPA_TASK_TIMEOUT | 任务执行超时，已停止运行。 |
| RPA_ACTION_UNSUPPORTED | 该节点不受当前版本支持（已下线或未开放）。 |


## 运行时

| code | 说明 |
|  --- | --- |
| INVALID_SEED | 调试缓存的节点结果无效，请重新运行前序节点。 |
| TASK_METADATA_REQUIRED | 缺少任务信息，无法生成默认产物路径。 |
| TIMEOUT | 节点执行超时，按失败处理并执行配置的重试、失败截图和异常处理；details.limit 为超时毫秒数，details.phase 为所处阶段。 |
| CANCELLED | 运行已按取消请求停止。 |
| OUTCOME_UNKNOWN | 运行停止未能确认，运行按失败显示，执行环境保持隔离直到确认停止；外部效果未确认，请勿自动重新运行。 |
| RPA_INTERRUPTED | 客户端退出或异常导致运行中断，运行按失败显示；请检查页面实际结果后再重新运行。 |
| ATOM_FAILED | 浏览器动作执行失败且无法识别具体原因，请结合失败节点输入、截图和页面状态排查。 |
| ATOM_IN_FLIGHT | 同一执行上下文中已有动作在运行。 |
| CONTEXT_ACTIVE | 执行上下文仍在使用中。 |
| CONTEXT_CLOSED | 执行上下文已关闭。 |
| CONTEXT_QUARANTINED | 前一个动作未能安全结束，执行上下文已隔离，后续节点不再执行。 |
| EXECUTION_FENCED | 运行已被停止，不再接受新的动作。 |
| WORKER_EXITED | 脚本执行进程意外退出。 |
| RPA_EXECUTION_FAILED | 流程执行失败，请查看失败节点记录。 |


## 客户端宿主

| code | 说明 |
|  --- | --- |
| GOOGLE_SHEETS_CONFIG_REQUIRED | Google Sheets 服务未配置。 |
| HOST_ADAPTER_REQUIRED | 该节点需要客户端环境能力，当前执行上下文不可用。 |
| RPA_INVALID_HOST_RESPONSE | 客户端返回的数据无效。 |
| RPA_PERMISSION_DENIED | 当前账号无权操作该环境。 |
| RPA_HOST_FAILED | 客户端处理失败。 |
| RPA_HOST_REQUEST_FAILED | 客户端向云端请求环境或账号数据失败；服务端拒绝时 details.upstreamCode 为服务端错误码，message 带服务端提示，否则为网络失败，请检查网络和登录状态后重试。 |
| RPA_HOST_TIMEOUT | 客户端处理超时，结果未确认。 |
| RPA_HOST_LOST | 与客户端页面的连接中断，结果未确认。 |
| RPA_HOST_UNAVAILABLE | 客户端主窗口不可用。 |
| RPA_HOST_INVALID_RESPONSE | 客户端返回的数据无效。 |
| RPA_SESSION_EXPIRED | 客户端会话已失效，请重新打开页面。 |


## Local API 请求

以下错误码由 Local API 请求本身返回（`error.code`、`issues[].code`、`warnings[].code`），不会出现在节点与运行记录中；HTTP 状态与恢复方式见[公共约定](/zh/browser-rpa/api/common)和[错误详情与恢复矩阵](/zh/browser-rpa/api/recovery)。

| code | 说明 |
|  --- | --- |
| RPA_LOGIN_REQUIRED | 请先登录 MoreLogin 客户端。 |
| RPA_NOT_FOUND | 资源不存在或不在当前账号/团队的数据范围内。 |
| RPA_INVALID_REQUEST | 请求格式不符合接口契约，请检查路径、参数、请求头和正文。 |
| RPA_INVALID_TEXT | 文本为空或不符合长度限制。 |
| RPA_PRECONDITION_REQUIRED | 请提供读取模板时返回的强 ETag 作为 If-Match。 |
| RPA_VERSION_CONFLICT | 模板已经修改，请重新读取并校验编辑候选。 |
| RPA_TEMPLATE_VERSION_CONFLICT | 请求中的模板版本已过期，请读取当前版本。 |
| RPA_CATALOG_CHANGED | 节点目录版本缺失或已过期，请刷新 capabilities 和节点契约。 |
| RPA_VALIDATION_FAILED | 流程校验失败，请按 issues 中的位置修正后重新校验。 |
| RPA_NODE_INPUT_INVALID | 节点输入不符合该节点的契约或取值限制。 |
| RPA_REFERENCE_NOT_FOUND | 引用的参数、节点或输出字段不存在。 |
| RPA_REFERENCE_ORDER_INVALID | 引用的节点在当前位置尚未执行。 |
| RPA_PRIVATE_DEFAULT_INVALID | 私密参数必须是 string 类型；publicState=retained 只能保留同一模板同名私密字段已有的默认值。 |
| RPA_PRIVATE_DEFAULT_UNAVAILABLE | 私密参数的默认值已无法从本机安全存储读取，本次按未设置默认值返回；如需默认值请重新提交明文。 |
| RPA_NODE_TITLE_GENERIC | 节点或分支的名称（data.title）缺省、为空或仍是编辑器的默认名称（动作名、“分支”“默认分支”），在编辑器里看不出这一步做什么；请写成说明用途的名称，例如“等待搜索结果出现”“找到目标视频”。只是提醒，不影响保存和运行。 |
| RPA_UNKNOWN_PARAMETER | 请求包含模板未声明的参数。 |
| RPA_REQUIRED_PARAMETER | 缺少模板声明的必填参数。 |
| RPA_REQUEST_CONFLICT | 同一幂等键已用于不同的请求意图。 |
| RPA_REQUEST_NOT_COMMITTED | 已确认该幂等键没有提交；原意图未变时可使用原键重试。 |
| RPA_REQUEST_EXPIRED | 该幂等键的恢复窗口已过期，请先核对资源状态。 |
| RPA_DEPENDENCY_UNAVAILABLE | 引用的子模板已删除或不可用，请修改引用后再运行。 |
| RPA_ENVIRONMENT_BUSY | 环境正在运行或隔离中，请待释放后重新预检。 |
| RPA_RATE_LIMITED | 请求过于频繁，请遵循 Retry-After 后重试。 |
| RPA_VALIDATION_TIMEOUT | 只读校验超时，未提交写入。 |
| RPA_SERVICE_BUSY | 服务暂时繁忙，请先查询原请求收据再决定是否重试。 |
| RPA_OUTCOME_UNKNOWN | 云端模板写入未收到确认，结果未知；同一幂等键不会再次写入，请先在模板列表中核对。 |
| RPA_INTERNAL | 服务处理失败，请保留 requestId 供排查，并核对写入收据。 |
| RPA_WORKFLOW_SCHEMA_INVALID | 流程结构不符合 workflow 契约；path 指出位置，reason 指出原因（必填、类型、枚举、范围、格式或未知字段）。 |
| RPA_STRUCTURE_INVALID | 流程必须以唯一的 start 节点开始、以唯一的 end 节点结束。 |
| RPA_DUPLICATE_NODE | 节点 ID 重复，请为每个节点使用唯一 ID。 |
| RPA_NODE_LIMIT | 流程中的节点数量超出上限，请拆分为子流程。 |
| RPA_DEPTH_LIMIT | 流程嵌套层级超出上限，请减少分组或分支嵌套。 |
| RPA_LIMIT_EXCEEDED | 请求内容超出大小或数量限制；details 中的 limit / maxBytes 为上限。 |
| RPA_REFERENCE_NOT_VISIBLE | 引用的节点在当前位置不可见（位于其他分支或在本节点之后），请改为引用在此之前必定执行的节点。 |
| RPA_REFERENCE_FIELD_NOT_FOUND | 引用的节点输出中没有该字段，请对照节点契约的 outputVariants 修改字段名。 |
| RPA_REFERENCE_EXPRESSION_UNSUPPORTED | ${…} 中只能写变量引用路径，不能写算式或其他表达式；数字计算请写在支持数字算式（numericExpression）的数字字段，例如 "${loop.data.index}+1"。 |
| RPA_INVALID_REFERENCE | 引用写法不合法：ref 只能包含 type 与 content，content 为非空字符串数组；constant 只能包含 type 与 content。 |
| RPA_RUNTIME_CHECK_REQUIRED | 引用的节点可能不会执行（条件分支或循环内），运行时如未产生该值将失败。 |
| RPA_AUTHORING_RESTRICTED | 该节点或字段包含仅限客户端界面编辑的敏感配置，Local API 不能写入。 |
| RPA_EXTERNAL_EXECUTION_RESTRICTED | 流程包含仅限客户端界面运行的节点，不能通过 Local API 运行。 |
| RPA_DEFAULT_CONFLICT | 同一参数同时给了 default 和 extra.defaultValue 且两者不一致，请只保留一种写法。 |
| RPA_PRIVATE_DEFAULT_CLEARED | 本次写入没有提交私密参数的默认值（明文或 publicState=retained），原默认值将被清除；如需保留请提交明文或 retained。 |
| RPA_REDACTED_CONTENT_READ_ONLY | 模板中有已脱敏的旧敏感字面量，需先在客户端迁移后才能通过 Local API 编辑或复制。 |
| RPA_INVALID_NODE_EDIT | 节点编辑操作不合法；issues 中的 path 指出出错的操作和字段。 |
| RPA_UNSUPPORTED_MEDIA_TYPE | 请求正文必须是 application/json。 |
| RPA_DEPENDENCY_VERSION_UNAVAILABLE | 引用的子模板版本不可用，请读取最新模板后重新校验。 |
| RPA_ENVIRONMENT_UNAVAILABLE | 无法解析指定浏览器环境，请核对已有环境列表及客户端状态。 |
| RPA_SERVICE_UNAVAILABLE | 浏览器 RPA 服务暂不可用（客户端未登录、正在启动或已关闭），请确认客户端已登录后重试。 |
| RPA_REQUEST_TIMEOUT | 客户端处理请求超时，结果未确认；写操作请先按原幂等键查询收据再决定是否重试。 |