错误码索引
本文档列出 Forge Admin 常见业务错误码、含义及解决建议。
通用错误码
| 错误码 | HTTP 状态 | 错误信息 | 说明 | 解决建议 |
|---|---|---|---|---|
| 200 | 200 | 操作成功 | 请求成功 | — |
| 401 | 401 | 未能读取到有效 token | 未登录或 Token 失效 | 检查请求头是否携带 Authorization，或重新登录 |
| 401 | 401 | token 已过期 | Token 超时 | 重新登录获取新 Token |
| 403 | 403 | 无权限 | 已登录但缺少所需权限 | 联系管理员分配对应角色或权限 |
| 500 | 500 | 系统异常 | 服务端未捕获异常 | 查看后端日志定位具体错误 |
业务错误码
| 错误码 | 错误信息 | 说明 | 解决建议 |
|---|---|---|---|
| 1001 | 参数校验失败 | 请求参数不合法 | 检查必填字段、字段类型与格式 |
| 1002 | 数据不存在 | 请求的资源不存在 | 确认 ID 是否正确，数据是否已被删除 |
| 1003 | 数据已存在 | 唯一约束冲突 | 检查名称、编码等唯一字段是否重复 |
| 1004 | 操作失败 | 业务逻辑执行失败 | 查看返回的 msg 字段获取详细原因 |
用户与权限错误
| 错误码 | 错误信息 | 说明 | 解决建议 |
|---|---|---|---|
| 1101 | 用户不存在或密码错误 | 登录失败 | 检查用户名与密码，默认 admin/123456 |
| 1102 | 用户已被停用 | 账号被禁用 | 联系管理员启用账号 |
| 1103 | 验证码错误 | 验证码不匹配或已过期 | 重新获取验证码 |
| 1104 | 角色编码已存在 | 角色编码重复 | 更换角色编码 |
| 1105 | 不能删除超级管理员 | 尝试删除内置管理员 | 超级管理员不可删除 |
租户错误
| 错误码 | 错误信息 | 说明 | 解决建议 |
|---|---|---|---|
| 1201 | 租户不存在 | 租户 ID 无效 | 确认租户已创建且状态正常 |
| 1202 | 租户已被停用 | 租户被禁用 | 联系平台管理员启用租户 |
| 1203 | 租户数据量超限 | 超出租户配额 | 升级租户套餐或清理数据 |
文件错误
| 错误码 | 错误信息 | 说明 | 解决建议 |
|---|---|---|---|
| 1301 | 文件上传失败 | 文件存储服务异常 | 检查 MinIO/OSS 配置与连通性 |
| 1302 | 文件大小超限 | 超出最大文件限制 | 压缩文件或联系管理员调整限制 |
| 1303 | 文件类型不允许 | 文件后缀不在白名单 | 确认允许的文件类型 |
错误响应格式
json
{
"code": 1001,
"msg": "参数校验失败：用户名不能为空",
"data": null
}💡 前端应在 Axios 响应拦截器中统一处理错误码，对 401 自动跳转登录，对其他错误展示
msg提示。