HTTPHTTP 状态码速查表
全面覆盖 HTTP 协议 1xx 到 5xx 状态码规范、前后端联调排错与缓存机制说明。
OK
请求成功。常规 GET、POST 响应的标准状态码。
Created
已创建。POST/PUT 成功并在服务端创建了新资源。
No Content
无内容。请求成功处理,但响应体不包含任何实体内容(如 DELETE 成功)。
Moved Permanently
永久重定向。资源已被分配了新的永久 URI,搜索引擎会转移权重。
Found
临时重定向。资源临时位于其他 URI,搜索引擎保留原 URL。
Not Modified
未修改。协商缓存命中(基于 ETag / If-Modified-Since),客户端可直接使用本地缓存。
Bad Request
客户端请求语法错误,如 JSON 格式损坏、缺少必填参数。
Unauthorized
未授权。当前请求需要用户身份验证凭证(Token/Cookie)或凭证无效。
Forbidden
禁止访问。服务器理解请求但拒绝授权,通常为权限不足(Role/ACL)。
Not Found
资源未找到。请求的 URL 路径在服务器上不存在。
Method Not Allowed
方法不允许。如接口只支持 POST,客户端使用了 GET 请求。
Too Many Requests
请求过多(限流)。用户在给定的时间内发送了过多请求(Rate Limit)。
Internal Server Error
服务器内部错误。后端代码抛出未捕获的未处理异常。
Bad Gateway
错误网关。作为网关或反向代理的服务器从上游服务接收到无效响应。
Service Unavailable
服务不可用。服务器目前无法处理请求,可能由于临时超载或停机维护。
Gateway Timeout
网关超时。反向代理(如 Nginx)向上游应用服务器请求超时未得到响应。