标准 HTTP 状态码详解
HTTP 状态码分类详解
| 分类 | 范围 | 含义 |
|---|---|---|
| 1xx 信息性 | 100–199 | 请求已接收，继续处理 |
| 2xx 成功 | 200–299 | 请求成功，服务器返回预期结果 |
| 3xx 重定向 | 300–399 | 客户端需进一步操作以完成请求 |
| 4xx 客户端错误 | 400–499 | 请求有误，客户端需修改请求 |
| 5xx 服务器错误 | 500–599 | 服务器处理请求时发生错误 |
常见状态码详解
1xx 信息性
100 Continue：初始请求已接受，继续发送剩余部分。
101 Switching Protocols：服务器同意客户端协议切换请求。
2xx 成功
200 OK：请求成功，返回数据。
201 Created：资源创建成功（常用于 POST）。
204 No Content：请求成功但无返回内容（如 DELETE）。
3xx 重定向
301 Moved Permanently：资源永久重定向到新地址。
302 Found：资源临时重定向。
304 Not Modified：资源未修改，可使用缓存。
4xx 客户端错误
400 Bad Request：请求格式错误或参数无效。
401 Unauthorized：未认证，需登录。
403 Forbidden：已认证但无权限访问。
404 Not Found：请求资源不存在。
429 Too Many Requests：请求频率过高，被限流。
5xx 服务器错误
500 Internal Server Error：服务器内部错误。
502 Bad Gateway：网关收到无效响应。
503 Service Unavailable：服务器暂时不可用（如维护中）。
504 Gateway Timeout：网关超时，未收到上游响应。
企业级建议
在企业级系统中，推荐使用标准 HTTP 状态码来表达请求结果，同时在响应体中提供结构化的业务错误信息：
HTTP/1.1 400 Bad Request
{"code": 1001,"message": "用户名或密码错误","errors": {"username": ["用户名不存在"]}
}
这样既保持了协议语义清晰，又方便前端统一处理和国际化。