服务器的“红绿灯”图解常见 HTTP 状态码 为什么我们需要状态码当你访问一个网页或调用一个 API 时浏览器客户端发送请求服务器处理后必须给个反馈。“成功了”“你找的东西不存在。”“你没权限看这个。”“我这边出错了。”HTTP 状态码就是用3 位数字来标准化这些反馈。它们分为5 大类首位数字决定了类别。 通俗比喻去餐厅吃饭1xx服务员说“收到菜单了厨房正在做…” (信息提示)2xx服务员端上菜“您的菜好了请慢用。” (成功)3xx服务员说“这道菜没了建议您去隔壁分店吃或者换一道菜。” (重定向)4xx服务员说“先生您没带钱401或者这是VIP包厢您进不去403或者您点的菜菜单上没有404。” (客户端错误)5xx经理出来说“不好意思厨房着火了/厨师罢工了今天做不了。” (服务器错误) 目录✅ 2xx 成功一切正常 3xx 重定向换个地方找❌ 4xx 客户端错误你的问题 5xx 服务器错误我的问题⚔️ 易混淆状态码深度辨析 总结与调试建议1. ✅ 2xx 成功一切正常这类状态码表示请求已被成功接收、理解、并接受。 200 OK含义最标准的成功响应。请求成功响应体中包含请求的数据。场景获取用户信息、加载列表、提交表单成功。注意如果是POST请求创建资源通常更推荐用201。 201 Created含义请求成功并且服务器创建了新的资源。场景注册新用户、上传新文件、创建订单。Header通常会包含Location头指向新资源的 URL。 204 No Content含义请求成功但响应体没有内容。场景删除资源 (DELETE)、更新资源但不需要返回最新数据 (PUT/PATCH)。优势节省带宽浏览器不会刷新当前页面内容。2. 3xx 重定向换个地方找这类状态码表示需要客户端采取进一步的操作才能完成请求。通常用于 URL 跳转。 301 Moved Permanently (永久重定向)含义资源已经被永久移动到了新的 URL。行为浏览器会缓存这个重定向。下次再访问旧 URL浏览器直接跳新 URL不再询问服务器。场景网站域名更换、HTTP 强制跳转 HTTPS。SEO搜索引擎会将权重转移到新 URL。 302 Found (临时重定向)含义资源暂时移动到了新的 URL。行为浏览器不缓存。每次访问旧 URL都会问服务器“现在去哪”场景未登录用户访问个人中心临时跳转到登录页A/B 测试临时跳转。注意早期规范中302 可能会将POST请求转为GET现代浏览器通常遵循307或308的语义来保持方法不变但 302 依然广泛存在。 304 Not Modified (协商缓存命中)含义资源未修改可以使用本地缓存。场景浏览器发送If-None-Match(ETag) 或If-Modified-Since服务器比对后发现文件没变返回 304不发送响应体。优势极大节省带宽加速页面加载。 307 308 (补充)307 Temporary Redirect类似 302但严格保持请求方法POST 还是 POST。308 Permanent Redirect类似 301但严格保持请求方法。在现代开发中如果需要保留 POST 方法的重定向优先使用 307/308。3. ❌ 4xx 客户端错误你的问题这类状态码表示客户端看起来发生了错误妨碍了服务器的处理。 400 Bad Request含义请求报文存在语法错误或参数不符合要求。场景JSON 格式错误、必填参数缺失、参数类型不对。调试检查前端发送的数据结构是否与后端接口定义一致。 401 Unauthorized (未认证)含义请求要求用户的身份认证。简单说“你是谁”场景Token 过期、Token 缺失、Token 无效。对策前端应引导用户重新登录刷新 Token。 403 Forbidden (禁止访问)含义服务器理解请求但拒绝执行。简单说“我知道你是谁但你没权限。”场景普通用户尝试访问管理员接口、IP 被黑名单拦截。区别401 是“没登录”403 是“登录了但权限不够”。 404 Not Found含义服务器无法找到请求的资源。场景URL 拼写错误、资源已被删除、路由配置错误。注意出于安全考虑有时服务器会对不存在的资源也返回 404而不是 403以防泄露系统结构。 405 Method Not Allowed含义请求方法GET/POST/PUT等不被允许。场景对只读接口发起了POST请求或对只写接口发起了GET请求。4. 5xx 服务器错误我的问题这类状态码表示服务器在处理请求的过程中发生了错误。 500 Internal Server Error含义服务器内部发生未知错误。场景代码抛出异常、数据库连接失败、空指针引用。对策这是后端的锅。前端通常显示“服务器繁忙请稍后再试”并记录日志供后端排查。 502 Bad Gateway含义网关或代理服务器从上游服务器收到了无效的响应。场景Nginx 反向代理后端服务但后端服务挂了或响应格式错误。常见于微服务架构中网关层报错。 503 Service Unavailable含义服务器暂时无法处理请求过载或维护。场景服务器正在进行停机维护、流量过大导致限流。Header通常会包含Retry-After告诉客户端多久后可以重试。 504 Gateway Timeout含义网关或代理服务器未及时从上游服务器收到响应。场景后端接口处理时间过长如复杂 SQL 查询、第三方 API 超时超过了 Nginx 设置的超时时间。5. ⚔️ 易混淆状态码深度辨析 401 vs 403状态码核心含义比喻解决方案401未认证(Unauthenticated)保安问“请出示证件。”登录、刷新 Token403未授权(Unauthorized/Forbidden)保安说“你有证件但这间房你不能进。”联系管理员提升权限 301 vs 302状态码类型缓存行为SEO 影响适用场景301永久强缓存权重转移域名变更、HTTP-HTTPS302临时不缓存权重保留临时活动页、登录跳转 502 vs 504状态码核心原因比喻502坏网关后端回了但回的是乱码或错误格式。传话人回来了但说的是胡话。504网关超时后端一直没回超时了。传话人出去太久没回来。6. 总结与调试建议 速查表代码关键词谁的问题200成功-301/302重定向配置问题304缓存性能优化400参数错前端(检查参数)401没登录前端(检查 Token)403没权限后端(检查权限配置)404找不到前端(检查 URL) 或后端(检查路由)500服务器崩后端(查日志)502/504网关错/超时运维/后端(查服务状态/耗时) 博主寄语前端开发遇到 4xx先自查参数、Token 和 URL遇到 5xx直接甩锅给后端附带截图和请求 ID。后端开发尽量返回精确的状态码。不要所有错误都返回 200 { code: 500 }也不要所有错误都返回 500。规范的 HTTP 状态码能让前端更容易做统一错误处理。调试技巧在 Chrome DevTools 的 Network 面板中可以通过筛选 Status Code 快速定位错误请求。红色通常代表 4xx/5xx。记住口诀2 开头万事吉数据到手心欢喜。3 开头要转移永久临时分仔细。4 开头客户错参数权限查仔细。5 开头服务器后端日志跑不起。401 是没登录403 是权不足。502 坏网关504 超时苦。希望这篇文档能帮你彻底搞懂 HTTP 状态码如果有疑问欢迎在评论区留言。喜欢这篇文章吗记得点赞、收藏、转发哦❤️
服务器的“红绿灯”：图解常见 HTTP 状态码
服务器的“红绿灯”图解常见 HTTP 状态码 为什么我们需要状态码当你访问一个网页或调用一个 API 时浏览器客户端发送请求服务器处理后必须给个反馈。“成功了”“你找的东西不存在。”“你没权限看这个。”“我这边出错了。”HTTP 状态码就是用3 位数字来标准化这些反馈。它们分为5 大类首位数字决定了类别。 通俗比喻去餐厅吃饭1xx服务员说“收到菜单了厨房正在做…” (信息提示)2xx服务员端上菜“您的菜好了请慢用。” (成功)3xx服务员说“这道菜没了建议您去隔壁分店吃或者换一道菜。” (重定向)4xx服务员说“先生您没带钱401或者这是VIP包厢您进不去403或者您点的菜菜单上没有404。” (客户端错误)5xx经理出来说“不好意思厨房着火了/厨师罢工了今天做不了。” (服务器错误) 目录✅ 2xx 成功一切正常 3xx 重定向换个地方找❌ 4xx 客户端错误你的问题 5xx 服务器错误我的问题⚔️ 易混淆状态码深度辨析 总结与调试建议1. ✅ 2xx 成功一切正常这类状态码表示请求已被成功接收、理解、并接受。 200 OK含义最标准的成功响应。请求成功响应体中包含请求的数据。场景获取用户信息、加载列表、提交表单成功。注意如果是POST请求创建资源通常更推荐用201。 201 Created含义请求成功并且服务器创建了新的资源。场景注册新用户、上传新文件、创建订单。Header通常会包含Location头指向新资源的 URL。 204 No Content含义请求成功但响应体没有内容。场景删除资源 (DELETE)、更新资源但不需要返回最新数据 (PUT/PATCH)。优势节省带宽浏览器不会刷新当前页面内容。2. 3xx 重定向换个地方找这类状态码表示需要客户端采取进一步的操作才能完成请求。通常用于 URL 跳转。 301 Moved Permanently (永久重定向)含义资源已经被永久移动到了新的 URL。行为浏览器会缓存这个重定向。下次再访问旧 URL浏览器直接跳新 URL不再询问服务器。场景网站域名更换、HTTP 强制跳转 HTTPS。SEO搜索引擎会将权重转移到新 URL。 302 Found (临时重定向)含义资源暂时移动到了新的 URL。行为浏览器不缓存。每次访问旧 URL都会问服务器“现在去哪”场景未登录用户访问个人中心临时跳转到登录页A/B 测试临时跳转。注意早期规范中302 可能会将POST请求转为GET现代浏览器通常遵循307或308的语义来保持方法不变但 302 依然广泛存在。 304 Not Modified (协商缓存命中)含义资源未修改可以使用本地缓存。场景浏览器发送If-None-Match(ETag) 或If-Modified-Since服务器比对后发现文件没变返回 304不发送响应体。优势极大节省带宽加速页面加载。 307 308 (补充)307 Temporary Redirect类似 302但严格保持请求方法POST 还是 POST。308 Permanent Redirect类似 301但严格保持请求方法。在现代开发中如果需要保留 POST 方法的重定向优先使用 307/308。3. ❌ 4xx 客户端错误你的问题这类状态码表示客户端看起来发生了错误妨碍了服务器的处理。 400 Bad Request含义请求报文存在语法错误或参数不符合要求。场景JSON 格式错误、必填参数缺失、参数类型不对。调试检查前端发送的数据结构是否与后端接口定义一致。 401 Unauthorized (未认证)含义请求要求用户的身份认证。简单说“你是谁”场景Token 过期、Token 缺失、Token 无效。对策前端应引导用户重新登录刷新 Token。 403 Forbidden (禁止访问)含义服务器理解请求但拒绝执行。简单说“我知道你是谁但你没权限。”场景普通用户尝试访问管理员接口、IP 被黑名单拦截。区别401 是“没登录”403 是“登录了但权限不够”。 404 Not Found含义服务器无法找到请求的资源。场景URL 拼写错误、资源已被删除、路由配置错误。注意出于安全考虑有时服务器会对不存在的资源也返回 404而不是 403以防泄露系统结构。 405 Method Not Allowed含义请求方法GET/POST/PUT等不被允许。场景对只读接口发起了POST请求或对只写接口发起了GET请求。4. 5xx 服务器错误我的问题这类状态码表示服务器在处理请求的过程中发生了错误。 500 Internal Server Error含义服务器内部发生未知错误。场景代码抛出异常、数据库连接失败、空指针引用。对策这是后端的锅。前端通常显示“服务器繁忙请稍后再试”并记录日志供后端排查。 502 Bad Gateway含义网关或代理服务器从上游服务器收到了无效的响应。场景Nginx 反向代理后端服务但后端服务挂了或响应格式错误。常见于微服务架构中网关层报错。 503 Service Unavailable含义服务器暂时无法处理请求过载或维护。场景服务器正在进行停机维护、流量过大导致限流。Header通常会包含Retry-After告诉客户端多久后可以重试。 504 Gateway Timeout含义网关或代理服务器未及时从上游服务器收到响应。场景后端接口处理时间过长如复杂 SQL 查询、第三方 API 超时超过了 Nginx 设置的超时时间。5. ⚔️ 易混淆状态码深度辨析 401 vs 403状态码核心含义比喻解决方案401未认证(Unauthenticated)保安问“请出示证件。”登录、刷新 Token403未授权(Unauthorized/Forbidden)保安说“你有证件但这间房你不能进。”联系管理员提升权限 301 vs 302状态码类型缓存行为SEO 影响适用场景301永久强缓存权重转移域名变更、HTTP-HTTPS302临时不缓存权重保留临时活动页、登录跳转 502 vs 504状态码核心原因比喻502坏网关后端回了但回的是乱码或错误格式。传话人回来了但说的是胡话。504网关超时后端一直没回超时了。传话人出去太久没回来。6. 总结与调试建议 速查表代码关键词谁的问题200成功-301/302重定向配置问题304缓存性能优化400参数错前端(检查参数)401没登录前端(检查 Token)403没权限后端(检查权限配置)404找不到前端(检查 URL) 或后端(检查路由)500服务器崩后端(查日志)502/504网关错/超时运维/后端(查服务状态/耗时) 博主寄语前端开发遇到 4xx先自查参数、Token 和 URL遇到 5xx直接甩锅给后端附带截图和请求 ID。后端开发尽量返回精确的状态码。不要所有错误都返回 200 { code: 500 }也不要所有错误都返回 500。规范的 HTTP 状态码能让前端更容易做统一错误处理。调试技巧在 Chrome DevTools 的 Network 面板中可以通过筛选 Status Code 快速定位错误请求。红色通常代表 4xx/5xx。记住口诀2 开头万事吉数据到手心欢喜。3 开头要转移永久临时分仔细。4 开头客户错参数权限查仔细。5 开头服务器后端日志跑不起。401 是没登录403 是权不足。502 坏网关504 超时苦。希望这篇文档能帮你彻底搞懂 HTTP 状态码如果有疑问欢迎在评论区留言。喜欢这篇文章吗记得点赞、收藏、转发哦❤️
