本地静态码表 · 无需上传 · 不发起任何网络请求
HTTP 状态码速查表
HTTP 状态码是服务器在响应头中返回的三位数字,用来表达这次请求的处理结果。首位数字决定响应的大类:2xx表示成功,4xx 表示请求本身有问题,5xx 表示服务端出错。排查接口问题、阅读文档或编写错误处理逻辑时,先确认落在哪一类,通常就能快速定位方向。
1xx信息响应
服务器已收到请求,请求还在处理中,客户端通常无需额外操作。
2xx成功
请求已被成功接收和处理,响应中包含所需结果。
3xx重定向
资源被移动到别处,客户端需要跟随 Location 头重新请求。
4xx客户端错误
请求本身有问题,重发同样内容通常仍会失败,应先修正请求。
5xx服务器错误
服务端在处理请求时出错,重试可能成功,但通常需要排查服务端日志。
如何使用状态码查询工具
1按码值或名称搜索
在搜索框输入三位码值(如 404)、英文名(如 Not Found)或中文说明关键词,列表会即时过滤。
2按类别筛选
使用「全部 / 1xx / 2xx / 3xx / 4xx / 5xx」筛选按钮,只看某一类状态码。
3查看卡片说明
每张卡片给出码值、英文名与中文解释,说明该状态码代表的具体含义。
4置顶常用状态码
点击卡片右侧的书签图标把常用状态码置顶,置顶项会集中显示在页面顶部。
常用状态码速查
下表是接口开发与联调中最常遇到的状态码,可作为日常参考。完整码表见页面顶部的搜索与筛选区域。
| 状态码 | 英文名称 | 含义 |
|---|
| 200 | OK | 请求成功 |
|---|
| 201 | Created | 资源已创建 |
|---|
| 204 | No Content | 成功但无响应体 |
|---|
| 301 | Moved Permanently | 永久重定向 |
|---|
| 304 | Not Modified | 命中缓存 |
|---|
| 400 | Bad Request | 请求格式错误 |
|---|
| 401 | Unauthorized | 未认证或认证失败 |
|---|
| 403 | Forbidden | 已认证但被拒绝 |
|---|
| 404 | Not Found | 资源不存在 |
|---|
| 429 | Too Many Requests | 触发限流 |
|---|
| 500 | Internal Server Error | 服务端异常 |
|---|
| 502 | Bad Gateway | 上游响应无效 |
|---|
| 503 | Service Unavailable | 服务过载或维护中 |
|---|
| 504 | Gateway Timeout | 上游响应超时 |
|---|
常见问题
401 和 403 有什么区别?
401 表示缺少或无效的身份凭据,客户端可以通过重新登录、携带令牌等方式解决。403 表示服务器理解请求但明确拒绝授权,重新认证通常也没有用,属于权限或业务规则层面的拒绝。
302 和 307 有什么区别?
302 是历史遗留码,部分客户端会在重定向时把 POST 改成 GET。307 保证重定向后请求方法保持不变。需要保持请求方法时优先使用 307(或永久场景下的 308)。
502 和 504 该怎么排查?
两者都说明问题出在网关一侧。502 通常是上游返回了无效响应,常见于上游进程崩溃或代理协议不匹配;504 是上游在规定时间内没有返回响应,常见于上游过慢或超时设置过短。
429 之后应该怎么处理?
429 表示触发了速率限制。正确做法是读取 Retry-After 响应头,按其给出的秒数退避后重试,并配合指数退避与请求去重,避免进一步加重限流。
置顶的状态码会保存到哪里?
只把状态码数值保存在当前浏览器的 localStorage 中,不涉及任何账号或服务端存储。清除浏览器站点数据即可删除。
这个工具会发起网络请求吗?
不会。整个码表是内置的静态数据,搜索、筛选与置顶全部在浏览器内完成,不访问任何远程接口。