HTTPHTTP 状态码速查表
查询常用 HTTP 状态码,定位认证、权限、缓存和网关问题。
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)向上游应用服务器请求超时未得到响应。
操作指南 · 示例 · 使用边界
如何使用与核对结果
适合接口联调时快速判断请求失败发生在客户端、认证授权、应用服务还是网关。状态码只是线索,需要结合响应头、请求 ID 和服务端日志确认。
操作步骤
- 输入数字或名称过滤常用状态码,例如 401、429 或 Gateway。
- 先确认状态码由源站还是 CDN / 反向代理返回,再检查响应体。
- 使用请求 ID 对照服务端日志;重试前确认接口幂等性与 Retry-After。
可复现示例
按状态码查找排错方向
输入
响应: HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer预期结果
优先检查令牌是否存在、是否过期、是否发给正确受众;403 则进一步检查权限。限制与容易忽略的细节
- 本页是常用码速查,并非 IANA 完整注册表。
- 304 是缓存验证响应,通常不带新的资源内容;不要当成普通重定向。
- 301/308 和 302/307 表达不同迁移意图,不能据此承诺搜索排名或收录。