HTTP 状态码与响应头
排障时最常见的状态码含义,以及几个容易误判的响应头。
状态码
| 码 | 含义 | 常见原因 |
|---|---|---|
| 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-Encoding | gzip/br | 压缩在反代时注意重复压缩 |
Location | 重定向目标 | 相对/绝对都可,注意协议 |
Set-Cookie | 会话 | Secure、HttpOnly、SameSite |
Strict-Transport-Security | 强制 HTTPS | 加了难回退 |
X-Forwarded-For | 来源链 | 可伪造,只信可信代理 |
Vary | 缓存维度 | 漏了 Accept-Encoding 会串内容 |
502 不一定是后端挂了
后端进程活着但监听地址错、端口不通、健康检查失败,都会表现为 502。先看反代错误日志里的 upstream 地址与原因。
使用说明:速查内容按常见发行版与主流版本整理,命令参数以
man 与官方文档为准;涉及容量与功耗的数字为标称值换算,实际会有差异。