HTTP状态码是客户端与服务器通信时的核心反馈机制，它们以三位数字的形式出现在HTTP响应头中，揭示了请求的处理结果。无论是开发者调试、运维排查还是API设计，理解这些状态码都至关重要。本文将系统解析常见的HTTP状态码及其应用场景，助您快速定位问题并优化Web服务。
一、1xx（信息响应）：请求已接收，继续处理
这类状态码表示临时响应，通常用于握手或协议升级。
-
100 Continue
客户端发送Expect: 100-continue请求头后，服务器若同意处理，返回此状态码。客户端随后可发送完整请求体（如大文件上传前验证权限）。 -
101 Switching Protocols
服务器同意客户端通过Upgrade头字段（如WebSocket）切换协议时返回，常见于HTTP升级到WebSocket的场景。 -
102 Processing (WebDAV)
表示服务器已接收请求但尚未完成处理，避免客户端因长时间等待而超时。
二、2xx（成功）：请求被正确处理
2xx状态码表示操作成功，但不同场景下响应内容差异显著。
-
200 OK
最通用的成功状态码，GET请求返回资源，PUT/POST返回操作结果。需注意：即使资源未修改（如重复提交），仍可能返回200。 -
201 Created
POST/PUT成功创建资源时返回，响应头需包含Location字段指向新资源地址（如/users/123）。 -
202 Accepted
请求已接受但未处理完成，适用于异步任务（如视频转码）。客户端需通过轮询或其他方式获取最终结果。 -
204 No Content
服务器执行成功但无返回内容，常见于DELETE请求或表单提交后无需跳转的场景。 -
206 Partial Content
响应部分内容，配合Range头实现断点续传或分片下载。视频网站常用此状态码。
三、3xx（重定向）：资源位置变化，需进一步操作
3xx状态码指引客户端转向新位置，但不同重定向类型对SEO和缓存有不同影响。
-
301 Moved Permanently
资源永久迁移，搜索引擎会更新索引。例如域名更换后，旧链接应返回301指向新地址。 -
302 Found
临时重定向，客户端应继续使用原URL发起请求。常见于短期的维护页面跳转。 -
304 Not Modified
客户端缓存有效，服务器通过If-Modified-Since或ETag验证后返回此状态码，可显著减少带宽消耗。 -
307 Temporary Redirect
与302类似，但强制要求客户端保持请求方法不变（如POST请求不会被改为GET）。 -
308 Permanent Redirect
类似301，同样要求保持原始请求方法。
四、4xx（客户端错误）：请求包含错误语法或无法完成
4xx错误通常由客户端请求不规范或权限问题导致。
-
400 Bad Request
通用客户端错误，如JSON格式错误、缺少必要参数。建议在响应体中提供具体错误描述（如{"error": "Invalid birth_date format"}）。 -
401 Unauthorized
未通过身份验证（如未携带JWT令牌）。需配合WWW-Authenticate头说明认证方式。 -
403 Forbidden
身份验证成功但无权访问（如普通用户访问管理员接口）。与401的区别在于是否已认证。 -
404 Not Found
资源不存在，可能因URL错误或资源已被删除。友好的404页面可提升用户体验。 -
409 Conflict
请求与当前资源状态冲突（如重复创建同名用户）。需客户端处理后重试。 -
429 Too Many Requests
请求频率超限，需配合Retry-After头提示重试时间。常用于API限流。
五、5xx（服务器错误）：服务器处理请求失败
5xx错误表明服务器端故障，需运维人员及时介入。
-
500 Internal Server Error
通用服务器错误，可能是代码异常或配置错误。应记录详细日志以便排查。 -
502 Bad Gateway
网关或代理服务器从上游服务器接收到无效响应（如Nginx连接的后端服务崩溃）。 -
503 Service Unavailable
服务器暂时不可用（如维护或过载）。Retry-After头可指示恢复时间。 -
504 Gateway Timeout
网关服务器未能及时从上游服务获取响应（如数据库查询超时）。
六、关键注意事项
-
状态码≠错误码
如204用于成功删除操作，304表示缓存有效，均非错误。 -
API设计规范
RESTful API应精准使用状态码：创建资源返回201，删除成功返回204，查询空列表仍返回200（而非404）。 -
自定义状态码风险
虽然HTTP允许扩展状态码（如599），但非标准状态码可能导致客户端兼容性问题。 -
SEO优化
错误使用301/302可能影响搜索引擎排名，临时维护页面建议使用503而非302。
结语
掌握HTTP状态码如同拥有诊断网络通信的“听诊器”。通过合理使用状态码，开发者可以构建更健壮的API系统，运维人员能快速定位故障。建议结合工具（如Chrome开发者工具、Postman）实时观察请求响应，加深对状态码的理解。
