HTTP / REFERENCE INDEX

码典

错误码不是答案,是定位问题的入口。输入码值、英文含义或中文场景,快速找到下一步该查哪里。
64 个结果点击分类可缩小范围

1xx 信息

请求已收到,仍在处理中
100
Continue
常见场景:继续发送请求体
排查建议:确认客户端是否正确处理 100 Continue 与 Expect 请求头
101
Switching Protocols
常见场景:升级到 WebSocket 等协议
排查建议:检查 Upgrade、Connection 头及代理是否支持协议升级
102
Processing
常见场景:WebDAV 长任务仍在处理
排查建议:检查长任务超时和客户端等待策略
103
Early Hints
常见场景:提前发送资源预加载提示
排查建议:确认 CDN 与浏览器是否支持 103,勿把它当最终响应
104
Upload Resumption Supported
常见场景:服务端临时支持可恢复上传协议
排查建议:这是有效期至 2026-11-13 的临时注册;核对 Upload-Complete 与断点偏移

2xx 成功

请求被正确接收并完成
200
OK
常见场景:查询、更新等请求成功
排查建议:核对响应体结构与业务状态,不要只看 HTTP 码
★ 常用
201
Created
常见场景:创建资源成功
排查建议:确认 Location 头和新资源标识是否返回
★ 常用
204
No Content
常见场景:成功但无需返回正文
排查建议:客户端不应继续解析 JSON;检查是否误返回响应体
★ 常用
202
Accepted
常见场景:异步任务已接收
排查建议:查询任务状态端点,避免误以为任务已经完成
203
Non-Authoritative Information
常见场景:代理返回了变换后的信息
排查建议:检查中间代理、缓存和原始数据源
205
Reset Content
常见场景:成功并要求重置表单视图
排查建议:确认客户端是否执行重置且不读取正文
206
Partial Content
常见场景:断点续传或分段下载
排查建议:检查 Range 与 Content-Range 是否一致
207
Multi-Status
常见场景:WebDAV 批量操作返回多结果
排查建议:逐项读取 XML 状态,不能只判断外层 207
208
Already Reported
常见场景:WebDAV 成员已在前文报告
排查建议:检查深层遍历是否正确去重
226
IM Used
常见场景:响应应用了增量编码
排查建议:核对 A-IM、ETag 与缓存实现

3xx 重定向

需要进一步操作才能完成请求
301
Moved Permanently
常见场景:资源永久迁移
排查建议:更新旧链接并检查缓存与 SEO;非 GET 方法留意重写
★ 常用
302
Found
常见场景:资源临时跳转
排查建议:检查客户端是否把 POST 改成 GET;需要保留方法时用 307
★ 常用
304
Not Modified
常见场景:缓存仍有效,无需传正文
排查建议:核对 If-None-Match、ETag、Last-Modified 和缓存层
★ 常用
300
Multiple Choices
常见场景:资源有多个可选表示
排查建议:提供明确选项或配置首选内容协商
303
See Other
常见场景:操作后跳转到另一个 GET 页面
排查建议:常用于 PRG;检查 Location 是否可访问
305
Use Proxy
常见场景:已废弃的代理指示
排查建议:不应在现代服务中使用,排查旧代理配置
306
(Unused)
常见场景:保留且不再使用
排查建议:若出现通常是非标准实现或错误映射
307
Temporary Redirect
常见场景:临时跳转并保留方法和请求体
排查建议:检查目标是否接受原 HTTP 方法
308
Permanent Redirect
常见场景:永久跳转并保留方法和请求体
排查建议:更新调用方地址,确认代理不会形成循环

4xx 客户端错误

请求本身或客户端状态有问题
400
Bad Request
常见场景:参数、JSON 或请求格式错误
排查建议:检查请求体语法、字段类型、Content-Type 与网关限制
★ 常用
401
Unauthorized
常见场景:未提供或未通过身份认证
排查建议:检查登录态、凭据有效期与 WWW-Authenticate
★ 常用
403
Forbidden
常见场景:身份已知但无访问权限
排查建议:检查角色、资源策略、CSRF、IP/WAF 规则
★ 常用
404
Not Found
常见场景:路由或资源不存在
排查建议:核对 URL、路由部署、资源 ID 和软删除状态
★ 常用
409
Conflict
常见场景:资源状态冲突
排查建议:检查版本号、唯一键、并发写入和幂等键
★ 常用
422
Unprocessable Content
常见场景:格式正确但语义或校验失败
排查建议:逐项展示字段错误,核对业务校验规则
★ 常用
429
Too Many Requests
常见场景:请求频率或配额超限
排查建议:读取 Retry-After,采用退避、限流与请求合并
★ 常用
402
Payment Required
常见场景:支付或额度条件未满足
排查建议:核对订阅、余额、账单状态及服务自定义语义
405
Method Not Allowed
常见场景:路由存在但方法不支持
排查建议:查看 Allow 头,核对 GET/POST/PUT 等方法
406
Not Acceptable
常见场景:无法生成客户端可接受的响应格式
排查建议:检查 Accept、语言与内容协商配置
407
Proxy Authentication Required
常见场景:代理要求认证
排查建议:检查代理账号与 Proxy-Authenticate 配置
408
Request Timeout
常见场景:服务器等待请求超时
排查建议:检查网络、上传大小、客户端发送速度和代理超时
410
Gone
常见场景:资源已永久删除
排查建议:移除旧引用;如可恢复应提供替代资源
411
Length Required
常见场景:缺少 Content-Length
排查建议:补充长度或确认服务器是否支持 chunked 传输
412
Precondition Failed
常见场景:If-Match 等前置条件失败
排查建议:刷新 ETag/版本后再提交,避免覆盖他人更新
413
Content Too Large
常见场景:请求体或上传文件过大
排查建议:调整文件大小、分片上传及网关/服务端限制
414
URI Too Long
常见场景:URL 或查询串过长
排查建议:改用请求体,减少查询参数并检查重定向循环
415
Unsupported Media Type
常见场景:请求内容类型不支持
排查建议:检查 Content-Type、编码和上传文件格式
416
Range Not Satisfiable
常见场景:请求的字节范围无效
排查建议:核对文件长度、Range 起止值与缓存版本
417
Expectation Failed
常见场景:无法满足 Expect 请求头
排查建议:去掉不必要的 Expect 或调整代理支持
418
(Unused)
常见场景:标准中保留但未分配用途
排查建议:若被用于彩蛋、反爬或限流,应按服务自定义语义排查
421
Misdirected Request
常见场景:请求被发往无法处理该主机的连接
排查建议:检查 HTTP/2 连接复用、SNI 和反向代理路由
423
Locked
常见场景:WebDAV 资源被锁定
排查建议:确认锁所有者、锁令牌和过期时间
424
Failed Dependency
常见场景:依赖操作失败导致当前操作失败
排查建议:先定位批量或 WebDAV 请求中的前序失败项
425
Too Early
常见场景:服务器拒绝可能被重放的早期请求
排查建议:关闭 0-RTT 或为操作增加幂等保护
426
Upgrade Required
常见场景:必须切换到指定协议
排查建议:查看 Upgrade 头并升级客户端协议
428
Precondition Required
常见场景:要求条件请求以防并发覆盖
排查建议:携带 If-Match 或 If-Unmodified-Since
431
Request Header Fields Too Large
常见场景:请求头总体或单项过大
排查建议:清理 Cookie、追踪头并检查代理头部限制
451
Unavailable For Legal Reasons
常见场景:因法律要求不可用
排查建议:查看合规说明与适用地区,不要通过重试绕过

5xx 服务端错误

服务器未能完成有效请求
500
Internal Server Error
常见场景:服务端出现未分类异常
排查建议:用请求 ID 查日志与堆栈,检查最近发布和依赖
★ 常用
502
Bad Gateway
常见场景:网关收到无效上游响应
排查建议:检查上游健康、DNS、TLS、端口和网关日志
★ 常用
503
Service Unavailable
常见场景:服务过载、维护或暂不可用
排查建议:读取 Retry-After,检查容量、熔断与健康检查
★ 常用
504
Gateway Timeout
常见场景:网关等待上游超时
排查建议:定位慢查询/慢依赖,校准各层超时并避免立即重试风暴
★ 常用
501
Not Implemented
常见场景:服务器不支持请求方法或能力
排查建议:确认接口版本与实现范围,勿盲目重试
505
HTTP Version Not Supported
常见场景:服务器不支持该 HTTP 版本
排查建议:调整客户端协议并检查代理协商
506
Variant Also Negotiates
常见场景:内容协商配置形成循环
排查建议:检查变体资源与协商规则
507
Insufficient Storage
常见场景:WebDAV 存储空间不足
排查建议:检查磁盘、配额、inode 与临时目录
508
Loop Detected
常见场景:WebDAV 操作检测到无限循环
排查建议:检查资源绑定、递归引用与代理循环
510
Not Extended (Obsoleted)
常见场景:已废止的扩展协商状态
排查建议:不应在新实现中使用;排查旧协议实验或错误映射
511
Network Authentication Required
常见场景:接入网络前需要认证
排查建议:打开网络登录页,检查 captive portal 状态