Agent-System/.doc/system-design/2026-09-28-error-code-catalog.md

错误码目录

日期：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。