HTTP 状态码与响应头

排障时最常见的状态码含义,以及几个容易误判的响应头。

速查2026-11-10约 2 分钟

状态码

码含义常见原因
200成功—
201已创建POST 成功
204无内容删除成功、预检
206部分内容Range 请求、断点续传
301永久重定向域名/协议迁移
302临时重定向登录跳转
304未修改缓存生效
307/308重定向且保持方法308 为永久
400请求格式错参数、JSON 结构
401未认证缺令牌、令牌过期
403无权限认证通过但无权访问
404不存在路由、静态文件
405方法不允许用 GET 调了 POST 接口
408请求超时客户端太慢
409冲突并发写、版本冲突
413实体过大上传超出限制
415类型不支持Content-Type 不对
429请求过多限流
500服务端错误未捕获异常
502网关错误后端不可达/崩溃
503不可用过载、维护
504网关超时后端处理超过超时

响应头

头作用注意
Cache-Control缓存策略no-store 才是真的不缓存
ETag资源版本配合 If-None-Match 返回 304
Content-Type类型与编码缺 charset 时中文可能乱码
Content-Encodinggzip/br压缩在反代时注意重复压缩
Location重定向目标相对/绝对都可,注意协议
Set-Cookie会话Secure、HttpOnly、SameSite
Strict-Transport-Security强制 HTTPS加了难回退
X-Forwarded-For来源链可伪造,只信可信代理
Vary缓存维度漏了 Accept-Encoding 会串内容
502 不一定是后端挂了

后端进程活着但监听地址错、端口不通、健康检查失败,都会表现为 502。先看反代错误日志里的 upstream 地址与原因。

使用说明:速查内容按常见发行版与主流版本整理,命令参数以 man 与官方文档为准;涉及容量与功耗的数字为标称值换算,实际会有差异。