HTTP 状态码是网络中服务器和客户端交流的重要方式。每次你在浏览器中登录一个网站，都会进行一系列请求，而这些请求的结果会通过状态码来表现。状态码不仅能帮助开发者排查问题，还能影响 SEO 等多个方面。因此，了解常见的 HTTP 状态码并知道如何应对是非常重要的。
一、1xx 信息性状态码
信息性状态码很少遇到，它们主要是通知客户端继续传输请求。
100 Continue
- 用途及具体情境： 该状态码表示服务器已收到请求头信息，我们可以继续发送请求主体。在上传大文件时很有用。
- 处理流程示例： 客户端发送一个初始请求头，服务器返回 100 Continue，客户端继续发送数据。
101 Switching Protocols
- 用途及具体情境： 服务器理解并愿意遵从客户端请求，通过协议切换来实现，比如从 HTTP 切换到 WebSocket。
- 示例说明： 采用 WebSocket 进行双向通信时，初次连接会使用 HTTP，然后升级为 WebSocket 协议。
二、2xx 成功状态码
成功状态码表示请求已成功被服务器处理。
200 OK
- 用途及具体情境： 请求成功，服务器返回资源。最常见的状态码。
- 常见使用示例： 浏览任意网页时成功加载资源。
201 Created
- 用途及具体情境： 请求成功并且服务器创建了新的资源，通常用于 POST 请求。
- 常见使用示例： 表单提交成功后创建新用户，服务器返回 201 状态码。
204 No Content
- 用途及具体情境： 请求成功但服务器没有内容返回。在避免页面刷新或资源冗余传输时有用。
- 常见使用示例： 前端发请求修改数据，服务器处理成功但无需返回内容时。
三、3xx 重定向状态码
重定向状态码表示需要客户端进行额外的操作才能完成请求。
301 Moved Permanently
- 用途及具体情境： 资源永久性移除了新位置。
- SEO 方面的影响： 有助于保持链接的权重和排名。
- 常见使用示例： 网站更换域名，旧域名重定向到新域名。
302 Found
- 用途及具体情境： 资源临时移除到新位置。
- 历史背景与当前使用： 初期用于临时重定向，现代常用于表示资源正在被暂时搬迁。
304 Not Modified
- 用途及具体情境： 资源未被修改，客户端缓存在使用。
- 缓存机制中的应用： 通过 ETag 或 Last-Modified 头部来设置。
四、4xx 客户端错误状态码
客户端错误状态码表示请求格式或数据有问题。
400 Bad Request
- 用途及具体情境： 请求格式有误或请求数据不合法。
- 常见错误原因与解决办法： 检查请求参数和数据格式。
401 Unauthorized
- 用途及具体情境： 需要用户认证。
- 授权机制与常用方案： 例如 OAuth 等认证方式。
403 Forbidden
- 用途及具体情境： 用户认证成功，但无权访问。
- 权限约束的使用： 例如访问管理员页面时普通用户收到 403。
404 Not Found
- 用途及具体情境： 请求的资源不存在。
- 对用户体验的影响： 常见的页面未找到错误，需要提供友好的界面。
- 常见解决方案： 检查 URL 是否正确，确保资源存在。
五、5xx 服务器错误状态码
服务器错误状态码表示服务器在处理请求时出错。
500 Internal Server Error
- 用途及具体情境： 服务器内部错误，无法处理请求。
- 常见错误原因及排查方法： 代码 bug，服务器配置问题，系统异常等。
502 Bad Gateway
- 用途及具体情境： 服务器作为网关或代理，从上游服务器接收到无效响应。
- 反向代理与网关的作用： 通常在负载均衡或代理服务器出问题时看到。
503 Service Unavailable
- 用途及具体情境： 服务器当前无法处理请求，一般是临时状态。
- 服务维护及负载过载处理： 例如服务器过载、维护中等。
六、其他不太常见但值得了解的状态码
有些状态码虽然不常见，但了解它们会拓宽你的知识面。
418 I'm a teapot
- 源自何处及其意义： 这个状态码源自 1998 年的 HTTP 愚人节笑话——"I'm a teapot"，表示服务器拒绝泡咖啡请求，因为它是个茶壶。
- 趣味与实际情况： 虽然不可用，但在开发者社区中广为人知，作为趣味性的调侃。
429 Too Many Requests
- 用途及具体情境： 表示客户端发送的请求过多，被限流。
- 流量限制机制： 常用在 API 接口限流，防止滥用。
借助 Apifox 排查状态码
Apifox 是一个非常强大的 API 测试、管理工具，也能够有效地用于 HTTP 状态码错误的排查和调试。Apifox 集成了 API 设计、调试、测试与文档生成的功能，使得你可以更加方便地进行 API 的调试与测试，轻松定位问题。
首先打开 Apifox 创建一个新的项目，在项目中，你可以为你的 API 设置适当的名称与描述，在左侧的请求列表中点击“新建请求”，配置请求的 URL、方法、请求头和请求体等信息，在“返回响应”中可以根据状态码来设置不同的响应数据结构，比如 200 时返回什么，400 时返回什么，这可以根据你的业务来明确定义，设置完毕后保存即可。
来到“运行”页，点击“发送”按钮发送请求，Apifox 会显示详细的请求与响应信息，包括状态码、响应头、响应体等。在响应部分你可以看到 HTTP 状态码，精确定位请求的问题所在，快去试试吧！
总结
通过这篇文章，我们系统地介绍了 HTTP 协议中常见的状态码及其使用情景。了解这些状态码将帮助你更好地调试和优化应用，并为用户提供更加友好的使用体验。遇到 HTTP 状态码问题时，可以使用 Apifox 来帮助解决，以实现快速定位。
学习更多：