| 标准 | RFC 9457 problem+json（取代 RFC 7807） |
|---|---|
| 字段 | type/title/status/detail/instance + 自定义扩展 |
| 媒体类型 | application/problem+json |
Problem Details 示例
Problem Details 示例
HTTP/1.1 422 Unprocessable Content
Content-Type: application/problem+json
{
"type": "https://api.example.com/errors/validation",
"title": "Validation failed",
"status": 422,
"detail": "email format invalid",
"instance": "/requests/01J2ABCD",
"errors": {"email": ["must be email"]}
}无论用不用标准格式，至少保证：稳定错误码 + 人类可读说明 + 请求追踪 ID 三要素。