# 错误码目录

日期：2026-09-28。稳定码注册在 `internal/errcode`。HTTP 响应信封仍是 `code`、`message`、`request_id`、`error`、`details`。`details.guide` 是本页对应码的排查短句。

## 怎么定位一次失败

1. 从响应、聊天失败气泡或访问日志取出 `code` 与 `request_id`。
2. 在服务日志里检索 `request_id`（错误日志字段还有 `code`、`status`、`method`、`path`）。5xx 记为 Error，4xx 记为 Warn。日志不写原始 SQL、密钥或堆栈。
3. 管理台「错误审计」调用 `GET /api/v1/admin/system/error-events`（权限 `system:audit:read`），可按 `code`、`request_id`、`class`、时间范围过滤。
4. 异步失败（任务收尾、事件死信/隔离、上下文后台扫描、提醒扫描）写入同一张表，`source=async`。没有 HTTP 请求时，`request_id` 可能是任务或事件标识。

## 常见原因

| 类别 | 常见原因 | 下一步 |
|---|---|---|
| transient | 超时、暂时不可用、后台扫描失败 | 稍后重试；用 request_id 看是否连续出现 |
| resumable | 文档忙、租约占用、阶段未完成 | 等待当前编辑或阶段结束后继续 |
| fatal | 权限、校验、不存在、账本不一致 | 按码的含义修正输入或权限，不要盲目重试 |
| cancelled | 任务被取消 | 确认是否为用户取消 |

## 负责模块与相关表

- 表 `error_events` 的唯一写者是 `internal/errorevents`（迁移 `deploy/postgres/goose/00078_2026-09-28-error-events-audit.sql`）。按环境数据库隔离，表内没有环境列。
- 审计写入超时或失败只降级为日志 `error_event_audit_degraded`，不改变 HTTP 响应。
- 领域哨兵仍留在各领域包。`internal/server/domain_http.go` 在启动时 `errcode.Bind`。`stream.ClassifyError` 优先读错误上的 `ErrorCode()`，字符串启发式只作为旧路径兜底。

## 码表

下表每行一条注册码：含义、排查步骤、负责模块。HTTP 列为建议状态；处理器已显式给出的状态优先。

| 错误码 | HTTP | 类别 | 模块 | 可重试 | 含义 | 排查 |
|---|---:|---|---|---|---|---|
| `APPROVER_CANNOT_EDIT` | 403 | fatal | docgov | 否 | 批准人不能修改文档内容 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 APPROVER_CANNOT_EDIT。负责模块：docgov。 |
| `ASSET_KEY_AND_FILE_REQUIRED` | 400 | fatal | server | 否 | asset_key and file required | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 ASSET_KEY_AND_FILE_REQUIRED。负责模块：server。 |
| `ASSET_NOT_FOUND` | 404 | fatal | server | 否 | asset not found | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 ASSET_NOT_FOUND。负责模块：server。 |
| `AUTHOR_ONLY_EDIT` | 403 | fatal | docgov | 否 | 只有编制人可以修改文档内容 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 AUTHOR_ONLY_EDIT。负责模块：docgov。 |
| `AUTH_BAD_CREDENTIALS` | 401 | fatal | auth | 否 | 用户名或密码错误 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 AUTH_BAD_CREDENTIALS。负责模块：auth。 |
| `AUTH_FORBIDDEN` | 403 | fatal | auth | 否 | 无权访问 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 AUTH_FORBIDDEN。负责模块：auth。 |
| `AUTH_LOGIN_REQUIRED` | 401 | fatal | auth | 否 | 请先登录 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 AUTH_LOGIN_REQUIRED。负责模块：auth。 |
| `AUTH_SESSION_EXPIRED` | 401 | fatal | auth | 否 | 未登录或登录已过期 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 AUTH_SESSION_EXPIRED。负责模块：auth。 |
| `AUTH_UNAUTHENTICATED` | 401 | fatal | auth | 否 | 未登录或登录已过期 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 AUTH_UNAUTHENTICATED。负责模块：auth。 |
| `AUTH_USERNAME_EXISTS` | 409 | fatal | auth | 否 | 用户名已存在 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 AUTH_USERNAME_EXISTS。负责模块：auth。 |
| `BATCH_NOT_FOUND` | 404 | fatal | server | 否 | batch not found | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 BATCH_NOT_FOUND。负责模块：server。 |
| `CANNOT_STORE_EMPTY_FILE` | 400 | fatal | server | 否 | cannot store empty file | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 CANNOT_STORE_EMPTY_FILE。负责模块：server。 |
| `CHANGE_PROPOSAL_PENDING` | 409 | resumable | docgov | 是 | 文档仍有待编制人确认的变更提案 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 CHANGE_PROPOSAL_PENDING。负责模块：docgov。 |
| `CHAT_MESSAGES_IMPORT_ENDPOINT_IS_ONLY_AVAILABLE_IN_DEV_D` | 400 | fatal | server | 否 | chat messages import endpoint is only available in dev/demo environment | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 CHAT_MESSAGES_IMPORT_ENDPOINT_IS_ONLY_AVAILABLE_IN_DEV_D。负责模块：server。 |
| `CHAT_TIMEOUT` | 504 | transient | stream | 是 | 生成回复超时，请稍后重试 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 CHAT_TIMEOUT。负责模块：stream。 |
| `CHAT_TURN_NOT_FOUND` | 404 | fatal | ctxmgr | 否 | 对话回合不存在 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 CHAT_TURN_NOT_FOUND。负责模块：ctxmgr。 |
| `CLIENT_TURN_ID_AND_SESSION_ID_REQUIRED` | 400 | fatal | server | 否 | client_turn_id and session_id required | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 CLIENT_TURN_ID_AND_SESSION_ID_REQUIRED。负责模块：server。 |
| `CTXMGR_BACKGROUND` | 500 | transient | ctxmgr | 是 | 上下文后台任务失败 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 CTXMGR_BACKGROUND。负责模块：ctxmgr。 |
| `DECISION_NONCE_AND_DECISION_DIGEST_REQUIRED` | 400 | fatal | server | 否 | decision_nonce and decision_digest required | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DECISION_NONCE_AND_DECISION_DIGEST_REQUIRED。负责模块：server。 |
| `DOCUMENT_CONTENT_ERROR` | 409 | fatal | docgov | 否 | 文档内容读取失败 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOCUMENT_CONTENT_ERROR。负责模块：docgov。 |
| `DOCUMENT_CONTENT_INTEGRITY_MISMATCH` | 409 | fatal | docgov | 否 | 文档内容校验不一致 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOCUMENT_CONTENT_INTEGRITY_MISMATCH。负责模块：docgov。 |
| `DOCUMENT_CONTENT_PROJECTION_DRIFT` | 409 | fatal | docgov | 否 | 文档内容投影与账本不一致 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOCUMENT_CONTENT_PROJECTION_DRIFT。负责模块：docgov。 |
| `DOCUMENT_CONTENT_PROJECTION_EMPTY` | 409 | fatal | docgov | 否 | 文档内容投影为空 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOCUMENT_CONTENT_PROJECTION_EMPTY。负责模块：docgov。 |
| `DOCUMENT_CONTENT_PROJECTION_MISSING` | 409 | fatal | docgov | 否 | 文档内容投影缺失 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOCUMENT_CONTENT_PROJECTION_MISSING。负责模块：docgov。 |
| `DOCUMENT_LOCKED` | 409 | resumable | docgov | 是 | 文档已锁定 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOCUMENT_LOCKED。负责模块：docgov。 |
| `DOCUMENT_NOT_FOUND` | 404 | fatal | docgov | 否 | 文档不存在 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOCUMENT_NOT_FOUND。负责模块：docgov。 |
| `DOC_BUSY` | 409 | fatal | docgov | 否 | 该文档正在编辑中，请等待现有任务完成 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOC_BUSY。负责模块：docgov。 |
| `DOC_ID_CANNOT_BE_EMPTY` | 400 | fatal | server | 否 | doc_id cannot be empty | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOC_ID_CANNOT_BE_EMPTY。负责模块：server。 |
| `DOC_ID_REQUIRED` | 400 | fatal | server | 否 | doc_id required | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOC_ID_REQUIRED。负责模块：server。 |
| `DOC_LEDGER_ERROR` | 500 | fatal | docgov | 否 | 文档职责账本写入失败，请重新开始会话 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOC_LEDGER_ERROR。负责模块：docgov。 |
| `DOC_TASK_BUSY` | 409 | resumable | projectinstance | 是 | 文档任务正在执行，暂不能改派 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 DOC_TASK_BUSY。负责模块：projectinstance。 |
| `EVENTS_AUTH_FAILURE` | 403 | fatal | events | 否 | 事件未通过授权 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 EVENTS_AUTH_FAILURE。负责模块：events。 |
| `EVENTS_DEAD` | 500 | fatal | events | 否 | 事件投递已进入死信 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 EVENTS_DEAD。负责模块：events。 |
| `EVENTS_INTEGRITY` | 500 | fatal | events | 否 | 事件完整性校验失败 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 EVENTS_INTEGRITY。负责模块：events。 |
| `EVENTS_QUARANTINE` | 500 | fatal | events | 否 | 事件已隔离，不会自动重试 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 EVENTS_QUARANTINE。负责模块：events。 |
| `EVENTS_STALE_FENCING` | 409 | resumable | events | 是 | 事件租约令牌已过期 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 EVENTS_STALE_FENCING。负责模块：events。 |
| `FILE_REQUIRED` | 400 | fatal | server | 否 | file required | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 FILE_REQUIRED。负责模块：server。 |
| `FILE_TYPE_NOT_SUPPORTED_BY_PARSER` | 400 | fatal | server | 否 | file type not supported by parser | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 FILE_TYPE_NOT_SUPPORTED_BY_PARSER。负责模块：server。 |
| `FORCE_EDIT_NOT_ALLOWED` | 409 | fatal | docgov | 否 | 当前不允许强制直接编辑 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 FORCE_EDIT_NOT_ALLOWED。负责模块：docgov。 |
| `FREEDOC_CONFLICT` | 409 | resumable | freedoc | 是 | 自由文档版本冲突 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 FREEDOC_CONFLICT。负责模块：freedoc。 |
| `FREEDOC_FORBIDDEN` | 403 | fatal | freedoc | 否 | 无权访问该自由文档 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 FREEDOC_FORBIDDEN。负责模块：freedoc。 |
| `FREEDOC_INVALID_PARAM` | 400 | fatal | freedoc | 否 | 自由文档参数无效 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 FREEDOC_INVALID_PARAM。负责模块：freedoc。 |
| `FREEDOC_NOT_EXPORTABLE` | 400 | fatal | freedoc | 否 | 该消息不能导出为文档 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 FREEDOC_NOT_EXPORTABLE。负责模块：freedoc。 |
| `FREEDOC_NOT_FOUND` | 404 | fatal | freedoc | 否 | 自由文档不存在 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 FREEDOC_NOT_FOUND。负责模块：freedoc。 |
| `IAM` | 400 | fatal | server | 否 | 工作流定义服务需要数据库 IAM | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 IAM。负责模块：server。 |
| `ID` | 400 | fatal | server | 否 | 无效的 id | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 ID。负责模块：server。 |
| `IDEMPOTENCY_CONFLICT` | 409 | resumable | server | 是 | 重复提交 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 IDEMPOTENCY_CONFLICT。负责模块：server。 |
| `IDEMPOTENCY_KEY_REUSED` | 409 | fatal | ctxmgr | 否 | 重复提交的内容不一致 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 IDEMPOTENCY_KEY_REUSED。负责模块：ctxmgr。 |
| `ID_2` | 400 | fatal | server | 否 | 无效的用户ID | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 ID_2。负责模块：server。 |
| `ID_3` | 400 | fatal | server | 否 | 无效的角色 ID | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 ID_3。负责模块：server。 |
| `INSTANCE_ACTIVATION_INVALID` | 400 | fatal | projectinstance | 否 | 激活令牌无效或已过期 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_ACTIVATION_INVALID。负责模块：projectinstance。 |
| `INSTANCE_ALREADY_ACTIVE` | 409 | resumable | projectinstance | 是 | 项目已有运行中的工作流实例 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_ALREADY_ACTIVE。负责模块：projectinstance。 |
| `INSTANCE_AUTHOR_ONLY_CHANGED` | 409 | resumable | projectinstance | 是 | 兼任总授权已变更，请重新预览并确认激活 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_AUTHOR_ONLY_CHANGED。负责模块：projectinstance。 |
| `INSTANCE_AUTHOR_ONLY_DISABLED` | 403 | fatal | projectinstance | 否 | 系统未授权编制人兼任审核批准 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_AUTHOR_ONLY_DISABLED。负责模块：projectinstance。 |
| `INSTANCE_AUTHOR_ONLY_UNAVAILABLE` | 503 | transient | projectinstance | 是 | 兼任总授权存储不可用 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_AUTHOR_ONLY_UNAVAILABLE。负责模块：projectinstance。 |
| `INSTANCE_CONFLICT` | 409 | resumable | projectinstance | 是 | 项目版本冲突，请刷新后重试 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_CONFLICT。负责模块：projectinstance。 |
| `INSTANCE_DOC_TASK_NOT_FOUND` | 404 | fatal | projectinstance | 否 | 文档任务不存在或已禁用 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_DOC_TASK_NOT_FOUND。负责模块：projectinstance。 |
| `INSTANCE_DUTY_FORBIDDEN` | 403 | fatal | projectinstance | 否 | 无权改派文档职责 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_DUTY_FORBIDDEN。负责模块：projectinstance。 |
| `INSTANCE_FORBIDDEN_NOT_CREATOR` | 403 | fatal | projectinstance | 否 | 仅项目创建人可配置工作流 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_FORBIDDEN_NOT_CREATOR。负责模块：projectinstance。 |
| `INSTANCE_INVALID_STAGE` | 400 | fatal | projectinstance | 否 | 无效的阶段 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_INVALID_STAGE。负责模块：projectinstance。 |
| `INSTANCE_LEGACY_SWITCH_BLOCKED` | 409 | fatal | projectinstance | 否 | 新项目请通过项目设置完成工作流激活 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_LEGACY_SWITCH_BLOCKED。负责模块：projectinstance。 |
| `INSTANCE_NOT_AVAILABLE` | 503 | transient | projectinstance | 是 | 项目实例服务不可用 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_NOT_AVAILABLE。负责模块：projectinstance。 |
| `INSTANCE_NOT_FOUND` | 404 | fatal | projectinstance | 否 | 工作流实例不存在 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_NOT_FOUND。负责模块：projectinstance。 |
| `INSTANCE_PLAN_CONFLICT` | 409 | resumable | projectinstance | 是 | 规划版本冲突，请刷新后重试 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_PLAN_CONFLICT。负责模块：projectinstance。 |
| `INSTANCE_PLAN_FROZEN` | 409 | fatal | projectinstance | 否 | 工作流已激活，规划已冻结 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_PLAN_FROZEN。负责模块：projectinstance。 |
| `INSTANCE_PLAN_RECONFIRM` | 409 | resumable | projectinstance | 是 | 规划已变更，请重新预览并确认 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_PLAN_RECONFIRM。负责模块：projectinstance。 |
| `INSTANCE_RECHECK_REQUIRED` | 409 | fatal | projectinstance | 否 | 该阶段有待复核标记，推进前须确认已知悉 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_RECHECK_REQUIRED。负责模块：projectinstance。 |
| `INSTANCE_REVISION_CONFLICT` | 409 | resumable | projectinstance | 是 | 实例版本冲突，请刷新后重试 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_REVISION_CONFLICT。负责模块：projectinstance。 |
| `INSTANCE_STAGE_GATE` | 400 | fatal | projectinstance | 否 | 阶段门禁未满足，必需文档尚未全部批准 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_STAGE_GATE。负责模块：projectinstance。 |
| `INSTANCE_STAGE_NOT_ACTIVE` | 409 | fatal | projectinstance | 否 | 目标阶段不是当前活动阶段 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_STAGE_NOT_ACTIVE。负责模块：projectinstance。 |
| `INSTANCE_STAGE_NOT_COMPLETED` | 400 | fatal | projectinstance | 否 | 只能再打开已完成的阶段 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_STAGE_NOT_COMPLETED。负责模块：projectinstance。 |
| `INSTANCE_SWITCH_FROZEN` | 409 | fatal | projectinstance | 否 | 运行中不能切换工作流，只能调整职责、审批和文档启用 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_SWITCH_FROZEN。负责模块：projectinstance。 |
| `INSTANCE_TERMINATION_DENIED` | 409 | fatal | projectinstance | 否 | 当前状态不允许终止 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_TERMINATION_DENIED。负责模块：projectinstance。 |
| `INSTANCE_VALIDATION_FAILED` | 400 | fatal | projectinstance | 否 | 工作流配置校验未通过 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INSTANCE_VALIDATION_FAILED。负责模块：projectinstance。 |
| `INTERNAL` | 500 | fatal | server | 否 | 请求无法完成 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INTERNAL。负责模块：server。 |
| `INTERNAL_ERROR` | 500 | fatal | server | 否 | 系统内部错误，请重新开始会话 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INTERNAL_ERROR。负责模块：server。 |
| `INVALID_ACTION_MUST_BE_APPROVE_OR_REJECT` | 400 | fatal | server | 否 | invalid action: must be approve or reject | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_ACTION_MUST_BE_APPROVE_OR_REJECT。负责模块：server。 |
| `INVALID_ASSET_ID` | 400 | fatal | server | 否 | invalid asset id | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_ASSET_ID。负责模块：server。 |
| `INVALID_ASSET_KEY` | 400 | fatal | server | 否 | invalid asset key | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_ASSET_KEY。负责模块：server。 |
| `INVALID_BATCH_ID` | 400 | fatal | server | 否 | invalid batch id | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_BATCH_ID。负责模块：server。 |
| `INVALID_COMMENT_ID` | 400 | fatal | server | 否 | invalid comment id | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_COMMENT_ID。负责模块：server。 |
| `INVALID_EDGE_ID` | 400 | fatal | server | 否 | invalid edge id | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_EDGE_ID。负责模块：server。 |
| `INVALID_INSTANCE_ID` | 400 | fatal | server | 否 | invalid instance id | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_INSTANCE_ID。负责模块：server。 |
| `INVALID_MARK_ID` | 400 | fatal | server | 否 | invalid mark id | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_MARK_ID。负责模块：server。 |
| `INVALID_MULTIPART` | 400 | fatal | server | 否 | invalid multipart | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_MULTIPART。负责模块：server。 |
| `INVALID_PROJECT_ID` | 400 | fatal | server | 否 | invalid project id | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_PROJECT_ID。负责模块：server。 |
| `INVALID_REPO_PATH` | 400 | fatal | server | 否 | invalid repo_path | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_REPO_PATH。负责模块：server。 |
| `INVALID_REQUEST_ID` | 400 | fatal | server | 否 | invalid request id | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_REQUEST_ID。负责模块：server。 |
| `INVALID_STATE_TRANSITION` | 409 | fatal | docgov | 否 | 文档状态不能这样流转 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_STATE_TRANSITION。负责模块：docgov。 |
| `INVALID_TASK_KEY` | 400 | fatal | server | 否 | invalid task key | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_TASK_KEY。负责模块：server。 |
| `INVALID_VERSION` | 409 | resumable | server | 是 | invalid version | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_VERSION。负责模块：server。 |
| `INVALID_WORKFLOW_ID` | 400 | fatal | server | 否 | invalid workflow id | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_WORKFLOW_ID。负责模块：server。 |
| `INVALID_WORKSPACE_PATH` | 400 | fatal | server | 否 | invalid workspace path | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 INVALID_WORKSPACE_PATH。负责模块：server。 |
| `KIND_MUST_BE_CONFIRM_OR_CANCEL` | 400 | fatal | server | 否 | kind must be confirm or cancel | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 KIND_MUST_BE_CONFIRM_OR_CANCEL。负责模块：server。 |
| `LEASE_EXPIRED` | 409 | resumable | docgov | 是 | 文档编辑租约已过期 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 LEASE_EXPIRED。负责模块：docgov。 |
| `LEASE_NOT_HELD` | 409 | resumable | docgov | 是 | 当前没有文档编辑租约 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 LEASE_NOT_HELD。负责模块：docgov。 |
| `LEASE_STALE` | 409 | resumable | docgov | 是 | 文档编辑租约已失效 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 LEASE_STALE。负责模块：docgov。 |
| `LIMIT` | 400 | fatal | server | 否 | 无效的 limit | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 LIMIT。负责模块：server。 |
| `LIST_EXECUTIONS_FAILED` | 400 | fatal | server | 否 | list executions failed | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 LIST_EXECUTIONS_FAILED。负责模块：server。 |
| `MAINTENANCE_BAD_STATUS` | 409 | fatal | maintenance | 否 | 当前状态不可取消 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MAINTENANCE_BAD_STATUS。负责模块：maintenance。 |
| `MAINTENANCE_CONFLICT_OPEN` | 409 | resumable | maintenance | 是 | 已有未结束的维护窗口 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MAINTENANCE_CONFLICT_OPEN。负责模块：maintenance。 |
| `MAINTENANCE_INVALID_WINDOW` | 400 | fatal | maintenance | 否 | 维护窗口参数无效 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MAINTENANCE_INVALID_WINDOW。负责模块：maintenance。 |
| `MAINTENANCE_NOT_FOUND` | 404 | fatal | maintenance | 否 | 维护窗口不存在 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MAINTENANCE_NOT_FOUND。负责模块：maintenance。 |
| `MESSAGE_CANNOT_BE_EMPTY` | 400 | fatal | server | 否 | message cannot be empty | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MESSAGE_CANNOT_BE_EMPTY。负责模块：server。 |
| `MESSAGE_MUST_BE_SENT_VIA_POST_JSON_BODY_NOT_GET_QUERY_T2` | 400 | fatal | server | 否 | message must be sent via POST JSON body, not GET query (T20-B11) | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MESSAGE_MUST_BE_SENT_VIA_POST_JSON_BODY_NOT_GET_QUERY_T2。负责模块：server。 |
| `MISSING_DATE_DAY_KEY_OR_ANCHOR_ID_QUERY_PARAM` | 400 | fatal | server | 否 | missing date/day_key or anchor_id query param | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MISSING_DATE_DAY_KEY_OR_ANCHOR_ID_QUERY_PARAM。负责模块：server。 |
| `MISSING_DOC_ID_QUERY_PARAM` | 400 | fatal | server | 否 | missing doc_id query param | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MISSING_DOC_ID_QUERY_PARAM。负责模块：server。 |
| `MISSING_OR_EMPTY_QUERY_PARAM_Q` | 400 | fatal | server | 否 | missing or empty query param 'q' | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MISSING_OR_EMPTY_QUERY_PARAM_Q。负责模块：server。 |
| `MISSING_OR_INVALID_PROJECT_ID_QUERY_PARAM` | 400 | fatal | server | 否 | missing or invalid project_id query param | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MISSING_OR_INVALID_PROJECT_ID_QUERY_PARAM。负责模块：server。 |
| `MISSING_QUERY_PARAM` | 400 | fatal | server | 否 | missing query param | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MISSING_QUERY_PARAM。负责模块：server。 |
| `MISSING_REQUIRED_FIELDS_SESSION_ID_OR_DAY_KEY` | 400 | fatal | server | 否 | missing required fields 'session_id' or 'day_key' | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MISSING_REQUIRED_FIELDS_SESSION_ID_OR_DAY_KEY。负责模块：server。 |
| `MISSING_REQUIRED_QUERY_PARAM_SESSION_ID` | 400 | fatal | server | 否 | missing required query param 'session_id' | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MISSING_REQUIRED_QUERY_PARAM_SESSION_ID。负责模块：server。 |
| `MISSING_SESSION_ID` | 400 | fatal | server | 否 | missing session_id | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MISSING_SESSION_ID。负责模块：server。 |
| `MISSING_SESSION_ID_QUERY_PARAM` | 400 | fatal | server | 否 | missing session_id query param | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MISSING_SESSION_ID_QUERY_PARAM。负责模块：server。 |
| `MSG_` | 400 | fatal | server | 否 | 仅原批准人或（批准人缺位时）项目创建人可批准再打开 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MSG_。负责模块：server。 |
| `MSG__2` | 400 | fatal | server | 否 | 只有该阶段文档职责人或创建人可以申请再打开 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MSG__2。负责模块：server。 |
| `MSG__3` | 400 | fatal | server | 否 | 姓名不能为空 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MSG__3。负责模块：server。 |
| `MSG__4` | 400 | fatal | server | 否 | 指定的角色不存在或已停用 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MSG__4。负责模块：server。 |
| `MSG__5` | 404 | fatal | server | 否 | 未找到该项目的打开标记 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MSG__5。负责模块：server。 |
| `MSG__6` | 400 | fatal | server | 否 | 申请不属于该项目 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MSG__6。负责模块：server。 |
| `MSG__7` | 400 | fatal | server | 否 | 看不见下游文档，不能裁决 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MSG__7。负责模块：server。 |
| `MSG__8` | 400 | fatal | server | 否 | 至少提供一个可更新字段 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MSG__8。负责模块：server。 |
| `MSG__9` | 400 | fatal | server | 否 | 追踪索引不可用 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 MSG__9。负责模块：server。 |
| `NETWORK_ERROR` | 502 | transient | stream | 是 | 网络连接异常，请稍后重试 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 NETWORK_ERROR。负责模块：stream。 |
| `PARSE_IS_IN_PROGRESS_OR_ALREADY_COMPLETE` | 409 | resumable | server | 是 | parse is in progress or already complete | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 PARSE_IS_IN_PROGRESS_OR_ALREADY_COMPLETE。负责模块：server。 |
| `PROJECT_NAME_DUPLICATE` | 409 | fatal | projectworkflow | 否 | 项目名称已存在 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 PROJECT_NAME_DUPLICATE。负责模块：projectworkflow。 |
| `PROJECT_NOT_FOUND` | 404 | fatal | projectworkflow | 否 | 项目不存在 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 PROJECT_NOT_FOUND。负责模块：projectworkflow。 |
| `PROJECT_ROLE_REQUIRED_WHEN_MEMBER_DOES_NOT_EXIST` | 400 | fatal | server | 否 | project_role required when member does not exist | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 PROJECT_ROLE_REQUIRED_WHEN_MEMBER_DOES_NOT_EXIST。负责模块：server。 |
| `PROJECT_ROLE_REQUIRED_WITH_DOCUMENT_DUTY` | 400 | fatal | server | 否 | project_role required with document_duty | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 PROJECT_ROLE_REQUIRED_WITH_DOCUMENT_DUTY。负责模块：server。 |
| `PROPOSAL_ALREADY_DECIDED` | 409 | fatal | docgov | 否 | 变更提案已裁决 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 PROPOSAL_ALREADY_DECIDED。负责模块：docgov。 |
| `PROPOSAL_ID_CANNOT_BE_EMPTY` | 400 | fatal | server | 否 | proposal_id cannot be empty | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 PROPOSAL_ID_CANNOT_BE_EMPTY。负责模块：server。 |
| `PROPOSAL_NOT_FOUND` | 404 | fatal | docgov | 否 | 变更提案不存在 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 PROPOSAL_NOT_FOUND。负责模块：docgov。 |
| `PROPOSED_CHANGES_CANNOT_BE_EMPTY` | 400 | fatal | server | 否 | proposed_changes cannot be empty | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 PROPOSED_CHANGES_CANNOT_BE_EMPTY。负责模块：server。 |
| `RATE_LIMITED` | 429 | transient | server | 是 | 请求过于频繁，请稍后重试 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 RATE_LIMITED。负责模块：server。 |
| `READ_FILE_FAILED` | 400 | fatal | server | 否 | read file failed | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 READ_FILE_FAILED。负责模块：server。 |
| `REJECT_REASON_REQUIRED` | 400 | fatal | docgov | 否 | 驳回必须填写原因 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 REJECT_REASON_REQUIRED。负责模块：docgov。 |
| `REMINDER_SCAN_FAILED` | 500 | transient | notification | 是 | 阶段提醒扫描失败 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 REMINDER_SCAN_FAILED。负责模块：notification。 |
| `REPO_PATH_REQUIRED` | 400 | fatal | server | 否 | repo_path required | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 REPO_PATH_REQUIRED。负责模块：server。 |
| `REQUEST_BODY_INVALID` | 400 | fatal | server | 否 | 无效的请求体 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 REQUEST_BODY_INVALID。负责模块：server。 |
| `REQUEST_INVALID` | 400 | fatal | server | 否 | 请求参数无效 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 REQUEST_INVALID。负责模块：server。 |
| `REQUEST_JSON_INVALID` | 400 | fatal | server | 否 | 无效的 JSON 请求体 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 REQUEST_JSON_INVALID。负责模块：server。 |
| `REQUEST_METHOD_NOT_ALLOWED` | 405 | fatal | server | 否 | 不支持的请求方法 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 REQUEST_METHOD_NOT_ALLOWED。负责模块：server。 |
| `RESOURCE_CONFLICT` | 409 | resumable | server | 是 | 资源版本冲突 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 RESOURCE_CONFLICT。负责模块：server。 |
| `RESOURCE_NOT_FOUND` | 404 | fatal | server | 否 | 资源不存在 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 RESOURCE_NOT_FOUND。负责模块：server。 |
| `REVIEWER_CANNOT_EDIT` | 403 | fatal | docgov | 否 | 审核人不能修改文档内容 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 REVIEWER_CANNOT_EDIT。负责模块：docgov。 |
| `RUNNER_RESULT_REJECTED` | 502 | fatal | stream | 否 | 助手执行结果校验失败，请重新开始任务 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 RUNNER_RESULT_REJECTED。负责模块：stream。 |
| `RUN_ID_REQUIRED` | 400 | fatal | server | 否 | run_id required | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 RUN_ID_REQUIRED。负责模块：server。 |
| `RUN_NOT_FOUND` | 404 | fatal | server | 否 | run not found | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 RUN_NOT_FOUND。负责模块：server。 |
| `SAVE_BINDING_FAILED` | 400 | fatal | server | 否 | save binding failed | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SAVE_BINDING_FAILED。负责模块：server。 |
| `SERVICE_UNAVAILABLE` | 503 | transient | server | 是 | 服务暂不可用 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SERVICE_UNAVAILABLE。负责模块：server。 |
| `SESSION_OR_PROJECT_CONTEXT_NOT_FOUND` | 404 | fatal | server | 否 | session or project context not found | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SESSION_OR_PROJECT_CONTEXT_NOT_FOUND。负责模块：server。 |
| `SESSION_OWNER_MISMATCH` | 403 | fatal | ctxmgr | 否 | 无权访问该会话 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SESSION_OWNER_MISMATCH。负责模块：ctxmgr。 |
| `SETTING_INVALID_VALUE` | 400 | fatal | sysadmin | 否 | 设置值类型不匹配 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SETTING_INVALID_VALUE。负责模块：sysadmin。 |
| `SETTING_NOT_FOUND` | 404 | fatal | sysadmin | 否 | 设置不存在 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SETTING_NOT_FOUND。负责模块：sysadmin。 |
| `SETTING_READ_ONLY` | 403 | fatal | sysadmin | 否 | 该设置为只读 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SETTING_READ_ONLY。负责模块：sysadmin。 |
| `SETTING_REVISION_CONFLICT` | 409 | resumable | sysadmin | 是 | 设置版本冲突，请刷新后重试 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SETTING_REVISION_CONFLICT。负责模块：sysadmin。 |
| `SETTING_REVISION_REQUIRED` | 400 | fatal | sysadmin | 否 | 该设置需要 expected_revision | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SETTING_REVISION_REQUIRED。负责模块：sysadmin。 |
| `SETTING_STORE_UNAVAILABLE` | 503 | transient | sysadmin | 是 | 设置存储不可用 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SETTING_STORE_UNAVAILABLE。负责模块：sysadmin。 |
| `SETTING_UNKNOWN` | 400 | fatal | sysadmin | 否 | 未知的设置键 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SETTING_UNKNOWN。负责模块：sysadmin。 |
| `STREAMING_UNSUPPORTED` | 400 | fatal | server | 否 | streaming unsupported | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 STREAMING_UNSUPPORTED。负责模块：server。 |
| `STREAMING_UNSUPPORTED_BY_UNDERLYING_CONNECTION` | 400 | fatal | server | 否 | streaming unsupported by underlying connection | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 STREAMING_UNSUPPORTED_BY_UNDERLYING_CONNECTION。负责模块：server。 |
| `SWBOOT_MERGE_FORBIDDEN` | 403 | fatal | swboot | 否 | 受控执行不会合并、推送或部署 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SWBOOT_MERGE_FORBIDDEN。负责模块：swboot。 |
| `SWBOOT_PATCH_DISABLED` | 403 | fatal | swboot | 否 | 受控补丁执行未开启 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SWBOOT_PATCH_DISABLED。负责模块：swboot。 |
| `SWBOOT_PATCH_UNIMPLEMENTED` | 501 | fatal | swboot | 否 | 受控补丁执行尚未放量 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SWBOOT_PATCH_UNIMPLEMENTED。负责模块：swboot。 |
| `SWBOOT_REPO_NOT_ALLOWLISTED` | 403 | fatal | swboot | 否 | 仓库路径不在允许列表 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 SWBOOT_REPO_NOT_ALLOWLISTED。负责模块：swboot。 |
| `TASKRUN_ALREADY_ACTIVE` | 409 | resumable | taskrun | 是 | 任务已在执行 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASKRUN_ALREADY_ACTIVE。负责模块：taskrun。 |
| `TASKRUN_BACKGROUND` | 500 | transient | taskrun | 是 | 任务后台处理失败 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASKRUN_BACKGROUND。负责模块：taskrun。 |
| `TASKRUN_CLEANUP_BLOCKED` | 409 | fatal | taskrun | 否 | 任务清理尚未满足核对条件 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASKRUN_CLEANUP_BLOCKED。负责模块：taskrun。 |
| `TASKRUN_IDEMPOTENCY_CONFLICT` | 409 | resumable | taskrun | 是 | 重复的任务提交 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASKRUN_IDEMPOTENCY_CONFLICT。负责模块：taskrun。 |
| `TASKRUN_NOT_RESUMABLE` | 409 | fatal | taskrun | 否 | 该任务不能继续 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASKRUN_NOT_RESUMABLE。负责模块：taskrun。 |
| `TASKRUN_SENSITIVE_PAYLOAD` | 400 | fatal | taskrun | 否 | 任务输入包含不允许的内容 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASKRUN_SENSITIVE_PAYLOAD。负责模块：taskrun。 |
| `TASKRUN_STORE_UNAVAILABLE` | 503 | transient | taskrun | 是 | 任务存储不可用 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASKRUN_STORE_UNAVAILABLE。负责模块：taskrun。 |
| `TASKRUN_TERMINAL_CONFLICT` | 409 | fatal | taskrun | 否 | 任务已结束，不能再次收口 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASKRUN_TERMINAL_CONFLICT。负责模块：taskrun。 |
| `TASKRUN_UNAUTHORIZED_BACKEND` | 403 | fatal | taskrun | 否 | 任务执行器未授权 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASKRUN_UNAUTHORIZED_BACKEND。负责模块：taskrun。 |
| `TASK_INTERRUPTED` | 409 | resumable | taskrun | 是 | 任务执行中断，可继续或重新开始 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASK_INTERRUPTED。负责模块：taskrun。 |
| `TASK_KEY` | 400 | fatal | server | 否 | 客户端不可覆盖 task_key | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASK_KEY。负责模块：server。 |
| `TASK_SCOPE_UNRESOLVED` | 400 | fatal | projectinstance | 否 | 无法确定任务所属阶段 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TASK_SCOPE_UNRESOLVED。负责模块：projectinstance。 |
| `TURN_NOT_FOUND` | 404 | fatal | server | 否 | turn not found | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 TURN_NOT_FOUND。负责模块：server。 |
| `UNAUTHORIZED_ACTOR` | 403 | fatal | docgov | 否 | 当前身份不能执行该文档动作 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 UNAUTHORIZED_ACTOR。负责模块：docgov。 |
| `UNKNOWN_WORKFLOW` | 400 | fatal | server | 否 | unknown workflow | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 UNKNOWN_WORKFLOW。负责模块：server。 |
| `UNSUPPORTED_CATEGORY` | 400 | fatal | server | 否 | unsupported category | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 UNSUPPORTED_CATEGORY。负责模块：server。 |
| `UPLOAD_TOO_LARGE` | 400 | fatal | server | 否 | upload too large | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 UPLOAD_TOO_LARGE。负责模块：server。 |
| `USER_ID_AND_PROJECT_ROLE_REQUIRED` | 400 | fatal | server | 否 | user_id and project_role required | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 USER_ID_AND_PROJECT_ROLE_REQUIRED。负责模块：server。 |
| `USER_ID_QUERY_REQUIRED` | 400 | fatal | server | 否 | user_id query required | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 USER_ID_QUERY_REQUIRED。负责模块：server。 |
| `USER_ID_REQUIRED` | 400 | fatal | server | 否 | user_id required | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 USER_ID_REQUIRED。负责模块：server。 |
| `VERSION_CONFLICT` | 409 | resumable | server | 是 | 资源版本冲突 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 VERSION_CONFLICT。负责模块：server。 |
| `WORKFLOW_CATALOG_UNAVAILABLE` | 503 | transient | server | 是 | workflow catalog unavailable | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 WORKFLOW_CATALOG_UNAVAILABLE。负责模块：server。 |
| `WORKFLOW_CONCURRENT_CONFLICT` | 409 | resumable | projectworkflow | 是 | 工作流选择版本落后或并发冲突，请刷新后重试 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 WORKFLOW_CONCURRENT_CONFLICT。负责模块：projectworkflow。 |
| `WORKFLOW_FORBIDDEN_NOT_CREATOR` | 403 | fatal | projectworkflow | 否 | 仅项目创建人有权切换激活工作流 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 WORKFLOW_FORBIDDEN_NOT_CREATOR。负责模块：projectworkflow。 |
| `WORKFLOW_INVALID_INPUT` | 400 | fatal | projectworkflow | 否 | 工作流参数无效 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 WORKFLOW_INVALID_INPUT。负责模块：projectworkflow。 |
| `WORKFLOW_KEY_IS_REQUIRED` | 400 | fatal | server | 否 | workflow_key is required | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 WORKFLOW_KEY_IS_REQUIRED。负责模块：server。 |
| `WORKFLOW_LEGACY_SWITCH_BLOCKED` | 409 | fatal | projectworkflow | 否 | 请通过项目设置完成工作流规划与激活 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 WORKFLOW_LEGACY_SWITCH_BLOCKED。负责模块：projectworkflow。 |
| `WORKFLOW_NOT_FOUND` | 404 | fatal | projectworkflow | 否 | 工作流定义不存在或未在项目启用 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 WORKFLOW_NOT_FOUND。负责模块：projectworkflow。 |
| `WORKFLOW_PREREQUISITE` | 400 | fatal | projectworkflow | 否 | 上游文档尚未满足，不能继续 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 WORKFLOW_PREREQUISITE。负责模块：projectworkflow。 |
| `WORKFLOW_UNAUTHENTICATED` | 401 | fatal | projectworkflow | 否 | 需要登录后操作工作流 | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 WORKFLOW_UNAUTHENTICATED。负责模块：projectworkflow。 |
| `WORKSPACE_NOT_AVAILABLE_FOR_RUN` | 503 | transient | server | 是 | workspace not available for run | 用 request_id 在服务日志或管理台「错误审计」中检索错误码 WORKSPACE_NOT_AVAILABLE_FOR_RUN。负责模块：server。 |