
一句话承诺:提供可抄的错误响应模板与分类表,快速统一前后端的错误处理。
分类 | 典型HTTP | 建议码段 | 示例 |
|---|---|---|---|
验证错误 | 400 | 1000-1999 | 字段缺失、格式错误 |
未认证 | 401 | 2000-2099 | Token无效或过期 |
无权限 | 403 | 2100-2199 | 角色不匹配 |
资源未找到 | 404 | 3000-3099 | ID不存在 |
业务冲突 | 409 | 4000-4099 | 状态不允许 |
服务器错误 | 500 | 5000-5999 | 异常未捕获 |

{
"code": 1001,
"http": 400,
"message": "字段校验失败",
"details": [
{ "field": "email", "issue": "格式不正确" },
{ "field": "age", "issue": "必须为正整数" }
],
"traceId": "abc-123"
}{
"code": 2001,
"http": 401,
"message": "未认证或Token过期",
"details": [],
"traceId": "abc-123"
}{
"code": 5001,
"http": 500,
"message": "服务器内部错误",
"details": [],
"traceId": "abc-123"
}JWT“过期刷新”太混乱?最简单的刷新策略与黑名单设计(时序图)。