Linux---常见的 http 状态码

点击关注，更多精彩

HTTP 状态码是服务器对客户端（如浏览器、APP）请求的响应状态标识，由 3 位数字组成，分 5 大类（以首位数字区分）。理解状态码能快速定位网络请求的成功、失败或异常原因。

1

这类状态码表示 “请求正在处理中”，客户端通常无需用户干预，自动后续操作。

• 100 Continue：服务器已接收请求，客户端可继续发送请求体（常用于大文件上传前的 “预检”）。

• 101 Switching Protocols：服务器同意客户端的协议升级请求（如从 HTTP/1.1 切换到 WebSocket）。

301 Moved Permanently：永久重定向，表示请求的资源已 “永久搬家” 到新地址，浏览器会自动缓存新地址，下次直接访问新地址。

例：旧域名www.old.com迁移到www.new.com，访问旧域名时返回 301 + 新域名，浏览器自动跳转到新站。

302 Found：临时重定向，表示资源临时搬到新地址，浏览器不会缓存新地址，下次请求仍会访问原地址。

例：未登录用户访问个人中心时，临时跳转到登录页（登录后可能回原页面，而非固定新地址）。

304 Not Modified：缓存命中专用，表示客户端请求的资源 “未修改”，服务器无需返回完整资源，直接告知客户端用本地缓存的版本即可（大幅节省带宽）。

例：第二次访问某网页时，浏览器发送 “资源最后修改时间” 给服务器，服务器发现未变，返回 304，浏览器直接显示本地缓存的页面。

307 Temporary Redirect：与 302 类似，但严格保留请求方法（302 可能将 POST 转为 GET，307 确保 POST 仍为 POST）。

例：临时跳转时需要保留表单提交的 POST 数据，避免数据丢失。

4

400 Bad Request：请求语法错误，服务器无法理解客户端的请求格式（如参数缺失、JSON 格式错误）。

例：调用 API 时漏传必选参数 user_id，服务器返回 400 并提示 “参数错误”。

401 Unauthorized：未授权，表示请求需要身份验证（如登录），但客户端未提供或提供的凭证无效。

5

500 Internal Server Error：最常见的服务器错误，表示服务器处理请求时发生 “未预料到的内部错误”（如代码 bug、数据库连接失败）。

例：API 代码中存在空指针异常，服务器返回 500 且无法返回正常数据。

502 Bad Gateway：网关错误，表示服务器作为 “网关 / 代理” 时，收到了上游服务器（如后端业务服务器）的无效响应。

例：Nginx 反向代理到后端 Tomcat 服务器，但 Tomcat 已宕机，Nginx 返回 502。

503 Service Unavailable：服务不可用，表示服务器暂时无法处理请求（如服务器过载、维护中），通常是临时状态。

例：电商大促时服务器压力过大，部分请求返回 503 提示 “服务繁忙，请重试”。

504 Gateway Timeout：网关超时，表示服务器作为网关 / 代理时，等待上游服务器响应超时（上游服务器处理太慢）。

例：Nginx 转发请求到后端 API 服务器，但 API 处理复杂查询耗时过长，Nginx 超时返回 504。

505 HTTP Version Not Supported：HTTP 版本不支持，表示服务器不支持客户端使用的 HTTP 协议版本（如客户端用 HTTP/3，服务器只支持 HTTP/1.1）。

排查思路

前端开发：

通过浏览器 “开发者工具”（F12→Network 面板）查看请求的 “Status Code”，快速判断：

404→检查 URL 是否拼写错误；

401/403→检查登录状态或权限配置；

500→联系后端开发排查代码 bug。

后端开发：

返回精准的状态码（而非全用 400/500），并在响应体中添加错误详情（如{"code":409,"msg":"用户名已存在"}），方便前端定位问题。

运维排查：

502/504→检查后端服务器是否宕机、网络是否通畅；

304 过多→确认缓存策略是否合理（避免缓存过期导致旧内容）；

429→调整限流规则或优化客户端请求频率。

公众号：初见别辞

你们点点“分享”，给我充点儿电吧~

壁纸自取区