📋 HTTP状态码参考
完整状态码速查 · 分类筛选 · 关键字搜索
| 状态码 | 英文名称 | 中文名称 | 说明 |
|---|
完整状态码速查 · 分类筛选 · 关键字搜索
| 状态码 | 英文名称 | 中文名称 | 说明 |
|---|
最常见的包括:200(成功)、301(永久重定向)、302(临时重定向)、400(请求错误)、401(未授权)、403(禁止)、404(未找到)、500(服务器内部错误)、502(网关错误)、503(服务不可用)。
4xx是客户端错误,表示请求有问题(如参数错误、权限不足、资源不存在)。5xx是服务端错误,表示服务器处理请求时出现问题。
301是永久重定向,浏览器会更新书签和缓存,SEO上会传递权重到新地址;302是临时重定向,浏览器不会更新书签。做网站改版、域名迁移用301,临时跳转用302。
404表示资源找不到(可能暂时没有),410表示资源已永久删除。对SEO来说,410更明确地告诉搜索引擎「这个页面不会再有了」,比404能更快地从索引中移除。
302常用于登录跳转、语言切换、临时活动页等场景。比如未登录访问需要登录的页面,服务器会先返回302,让浏览器跳转到登录页。
502 Bad Gateway 表示网关或代理从上游服务器收到了无效响应,通常是后端服务挂掉或返回了错误;504 Gateway Timeout 表示网关等待上游服务器响应的超时了,通常是后端处理太慢。
401表示「未认证」,你没登录或登录态过期,需要先认证;403表示「无权限」,你已经登录了但这个资源不允许你访问。简单说401问你是谁,403说你不配。
429是请求过于频繁,触发了限流。解决方法是降低请求频率、增加重试间隔、等待一段时间再试。很多API都会用429来防止滥用。
HTTP状态码由三位数字组成,第一位数字代表响应的大类,共分五类。理解分类规则,遇到任何状态码都能快速判断问题方向。
| 分类 | 范围 | 含义 | 典型码 |
|---|---|---|---|
| 1xx 信息性 | 100-199 | 请求已接收,继续处理 | 100, 101, 103 |
| 2xx 成功 | 200-299 | 请求成功处理 | 200, 201, 204 |
| 3xx 重定向 | 300-399 | 需要进一步操作完成请求 | 301, 302, 304 |
| 4xx 客户端错误 | 400-499 | 客户端请求有问题 | 400, 401, 403, 404, 429 |
| 5xx 服务端错误 | 500-599 | 服务器处理出错 | 500, 502, 503, 504 |
排查时最好用浏览器开发者工具(Network面板)或curl查看完整响应头和响应体,错误详情往往藏在响应体里。
500 是笼统的服务器内部错误,看到它先看后端日志;502 是网关拿不到上游的「有效」响应,常见于后端程序崩溃;504 是网关等不及上游响应,常见于后端超时。
排查5xx时,优先看应用日志和nginx错误日志,再检查数据库连接数和上游服务状态。
搜索引擎爬虫会依据状态码决定如何处理页面:200正常收录、301把权重转移到新地址、404不收录、410快速移除。
| 状态码 | 名称 | 含义 | 典型场景 |
|---|---|---|---|
| 200 | OK | 成功 | 正常请求 |
| 201 | Created | 已创建 | 新建资源成功 |
| 204 | No Content | 无内容 | 成功但无返回体 |
| 301 | Moved Permanently | 永久重定向 | 域名迁移/SEO |
| 302 | Found | 临时重定向 | 登录跳转 |
| 304 | Not Modified | 未修改 | 走缓存 |
| 400 | Bad Request | 请求错误 | 参数格式不对 |
| 401 | Unauthorized | 未认证 | 未登录/token过期 |
| 403 | Forbidden | 无权限 | 权限不足 |
| 404 | Not Found | 未找到 | 资源不存在 |
| 405 | Method Not Allowed | 方法不允许 | 用错请求方法 |
| 429 | Too Many Requests | 请求过多 | 触发限流 |
| 500 | Internal Server Error | 服务器错误 | 程序异常 |
| 502 | Bad Gateway | 网关错误 | 上游无有效响应 |
| 503 | Service Unavailable | 服务不可用 | 维护/过载 |
| 504 | Gateway Timeout | 网关超时 | 上游响应超时 |
| 状态码 | 含义 | 排查方向 |
|---|---|---|
| 400 | 参数错误 | 检查请求体格式与必填字段 |
| 401 | 未认证 | 检查token/登录态 |
| 403 | 无权限 | 检查账号权限/IP白名单 |
| 404 | 接口不存在 | 核对路由路径 |
| 405 | 方法错误 | 检查请求方法 |
| 422 | 语义错误 | 参数格式对但内容不合法 |
| 429 | 限流 | 降低频率/等待重试 |
| 500 | 服务端异常 | 看后端日志 |
1. 点击顶部分类标签筛选(1xx/2xx/3xx/4xx/5xx)。
2. 在搜索框中输入关键词过滤状态码。
3. 查看状态码编号、名称、说明和典型使用场景。