常用状态码
HTTP 状态码是服务器在响应客户端请求时返回的三位数字代码,它们就像是服务器在对话中使用的“快捷短语”,告诉你请求是成功、需要进一步操作、出错或是其他情况。
1xx - 信息性状态码
表示请求已被接收,需要继续处理 。
100
信息性
Continue
客户端在发送较大请求体前,征询服务器意见,服务器同意接收 。
101
信息性
Switching Protocols
服务器应客户端请求切换协议,如升级到 WebSocket 。
2xx - 成功状态码
表示请求已被服务器成功接收、理解并处理 。
200
成功
OK
标准成功响应,请求成功,响应体中包含所需资源 。
201
成功
Created
资源创建成功,通常用于 POST或 PUT请求,响应头应包含新资源的 URI(Location)
。
204
成功
No Content
请求成功,但无返回内容。常用于 DELETE请求成功或 PUT/POST更新后无需返回数据
。
206
成功
Partial Content
部分内容。客户端进行了范围请求(Range头),服务器成功返回部分资源,用于断点续传或大文件分块下载 。
3xx - 重定向状态码
表示需要客户端执行进一步的操作才能完成请求 。
301
重定向
Moved Permanently
永久重定向。请求的资源已永久移动到新位置,搜索引擎会更新索引。用户应更新书签 。
302
重定向
Found
临时重定向。资源临时从不同 URI 响应,客户端应继续使用原始 URI。但实际应用中,许多浏览器会将其作为 303 处理 。
304
重定向
Not Modified
资源未修改。当客户端发起条件请求(如携带 If-Modified-Since头)时,如果资源未变,服务器返回此状态,告知客户端可继续使用缓存
。
307/ 308
重定向
Temporary / Permanent Redirect
临时/永久重定向。与 302/301 类似,但严格要求客户端在重定向时不得改变原有的 HTTP 方法(如 POST 重定向后仍为 POST) 。
4xx - 客户端错误状态码
表示客户端的请求有错误,服务器无法或不会处理该请求 。
400
客户端错误
Bad Request
请求报文存在语法错误。例如,JSON 格式错误、缺少必要参数、参数类型不匹配等 。
401
客户端错误
Unauthorized
未认证。请求需要用户认证,但未能提供有效的身份凭证。响应通常包含 WWW-Authenticate头告知如何认证
。
403
客户端错误
Forbidden
已认证,但无权限。服务器理解请求,但拒绝执行,通常因为权限不足 。
404
客户端错误
Not Found
资源未找到。服务器上不存在所请求的资源 。
429
客户端错误
Too Many Requests
请求过于频繁。客户端在给定时间内发送了太多请求,触发了服务器的速率限制。响应头可包含 Retry-After提示重试时间
。
5xx - 服务器错误状态码
表示服务器在处理请求的过程中发生了错误 。
500
服务器错误
Internal Server Error
通用服务器内部错误。一个笼统的错误代码,表示服务器遇到了意外情况,无法完成请求 。
502
服务器错误
Bad Gateway
错误网关。当服务器作为网关或代理时,从上游服务器收到了一个无效的响应 。
503
服务器错误
Service Unavailable
服务不可用。服务器当前由于超载、停机维护等原因无法处理请求,这通常是临时状态。响应头可包含 Retry-After估计服务恢复时间
。
504
服务器错误
Gateway Timeout
网关超时。服务器作为网关或代理,未能及时从上游服务器收到响应 。
最后更新于