Appearance
Error Codes
本文档汇总 EO Platform 数据管理服务的错误码、含义与常见触发场景，帮助你在调试或运维过程中迅速定位问题。平台服务端通过 CommonAuthException 抛出业务异常，并由公共模块 po_common_kit/common_auth 的 GlobalKsatExceptionHandler 统一返回如下响应结构：
json
{
"code": "<int>",
"message": "<string>"
}所有错误码定义集中维护在 ErrorCodeEnum.java，请在新增或变更业务异常时同步更新。
通用认证与账号类错误码
| 错误码 | 标识符 | 含义 | 常见触发场景 |
|---|---|---|---|
| 100 | TOKEN_NULL | token 为空 | 缺少 Authorization 请求头 |
| 101 | TOKEN_ERROR | token 无效或过期 | token 解析失败或超时 |
| 102 | USERNAME_PASSWORD_IS_NULL | 用户名或密码为空 | 登录参数缺失 |
| 103 | USER_NOT_FOUND | 用户未注册 | 账号不存在 |
| 104 | PASSWORD_ERROR | 密码错误 | 登录密码不匹配 |
| 105 | REG_REPEAT_ERROR | 用户名重复 | 注册时用户名已存在 |
| 106 | USERID_WORKER_ID_EMPTY | 不能生成用户 ID | 分布式 ID 工人号缺失 |
| 107 | IMAGE_ID_WORKER_ID_EMPTY | 不能生成影像 ID | 分布式 ID 工人号缺失（影像） |
| 108 | ID_NULL | ID 非法 | 关键 ID 参数为空 |
| 109 | ROLE_ALREADY_EXIST | 角色已存在 | 新增角色命名冲突 |
| 110 | ROLE_NOT_EXIST | 角色不存在 | 角色 ID 无效 |
| 111 | AUTHORITY_NOT_EXIST | 权限不存在 | 权限 ID 无效 |
| 112 | AUTHORITY_EXIST | 权限已存在 | 新增权限重名 |
| 113 | PARAMS_ERROR | 请求参数错误 | 参数校验失败或非法 |
| 114 | EMAIL_CODE_ERROR | 邮箱验证码错误 | 验证码不匹配 |
| 115 | REG_EMAIL_REPEAT_ERROR | 邮箱重复 | 注册邮箱已被使用 |
| 116 | REG_THIRD_REPEAT_ERROR | 第三方账号重复 | 第三方账户已绑定 |
| 117 | EMAIL_CODE_EXPIRED | 邮箱验证码过期 | 验证码超时 |
| 118 | OLD_PASSWORD_ERROR | 旧密码错误 | 修改密码时旧密码校验失败 |
数据管理服务专用错误码（10000–10029）
| 错误码 | 标识符 | 含义 | 常见触发场景 |
|---|---|---|---|
| 10000 | DATA_NOT_EXIST | 数据不存在 | 查询目标缺失 |
| 10001 | PARENT_ID_NOT_FIND | 父目录不存在 | 新建或移动文件父级无效 |
| 10002 | NEW_DIR_FAIL | 创建目录失败 | 底层写入异常 |
| 10003 | META_DATA_NOT_EXIST | 元数据不存在 | 元数据 ID 无效 |
| 10004 | DATA_FILE_NOT_EXIST | 数据文件不存在 | 文件 ID 无效 |
| 10005 | METADATA_TASK_NOT_EXIST | 发布任务不存在 | 任务记录缺失 |
| 10006 | DATA_PUBLISHING | 数据发布中 | 重复发起发布 |
| 10007 | DATA_PUBLISHED | 数据已发布 | 重复发布 |
| 10008 | FILE_ID_NOT_FIND | 文件 ID 不存在 | 回调或查询时找不到文件 |
| 10009 | FILE_DOWNLOAD_ADDRESS_NOT_EXIST | 下载地址缺失 | 发布后未生成下载地址 |
| 10010 | NOT_PUBLISHED_COMPLETE | 发布未完成 | 查询或下载尚未完成的数据 |
| 10011 | GET_LAYER_PUBLISHING_ADDRESS_EXCEPTIONAL | 图层发布地址异常 | 外部发布接口失败 |
| 10012 | UER_AOI_NOT_EXIST | 用户 AOI 不存在 | AOI ID 无效 |
| 10013 | METADATA_ANALYSIS_TASK_NOT_EXIST | 分析任务不存在 | 分析任务 ID 无效 |
| 10014 | ANALYSIS_TASK_NOT_COMPLETED | 分析任务未完成 | 任务仍在执行 |
| 10015 | API_CALL_FAILED | 外部 API 调用失败 | 调用第三方或内部服务异常 |
| 10016 | AI_MODEL_SESSION_QUESTION_NOT_EXIST | AI 会话问题不存在 | AI 会话数据缺失 |
| 10017 | AI_MODEL_SESSION_QA_ACTION_NOT_EXIST | AI 会话动作不存在 | AI 行为数据缺失 |
| 10018 | AI_MODEL_SEMANTIC_RECOGNITION_ERROR | AI 语义识别失败 | 模型无法识别指令 |
| 10019 | ANALYSIS_ALGORITHM_NOT_EXIST | 分析算法不存在 | 算法编号无效 |
| 10020 | LOGIN_PASSWORD_FAILED_MAX_LIMITS | 密码输错超限 | 连续输错 ≥10 次 |
| 10021 | RESET_PASSWORD_MAX_LIMITS | 重置密码超限 | 30 分钟内超过 5 次 |
| 10022 | SEND_INVITE_FAILED | 邀请邮件发送失败 | 邮件服务异常 |
| 10023 | EXPORT_USER_FAILED | 导出用户失败 | 导出流程异常 |
| 10024 | IMPORT_USER_FAILED | 导入用户失败 | 导入校验或写入失败 |
| 10025 | WORK_ORDER_NO_EXISTED | 工单号已存在 | 工单编号重复 |
| 10026 | PARENT_NOT_FOLDER | 父级不是文件夹 | 移动或创建到文件节点 |
| 10027 | NEW_FILE_FAIL | 创建文件失败 | 文件生成异常 |
| 10028 | CANNOT_MOVE_TO_CHILD | 不能移动到子目录 | 防止目录自包含 |
| 10029 | DATA_FILE_NOT_FIND | 数据文件未找到 | 数据库缺失或已删除 |
使用建议
- 前端展示：优先使用服务端返回的
code与message，必要时在本地做友好文案映射，避免硬编码。 - 日志排查：服务端会记录
CommonAuthException，结合错误码能快速定位触发方法和上下游调用。 - 变更同步：新增或调整错误码时，请同时更新公共枚举、此文档以及对应的 API 文档，确保团队对齐。
- 自动化监控：在告警系统中订阅关键错误码（如 10006、10015、10020）以便在异常高发时及时响应。