UTIL
.
PLUS
HTTP 状态码
更多工具
简体中文
搜索状态码或关键字
搜索状态码或关键字
全部
1xx
2xx
3xx
4xx
5xx
100
Continue
服务器已接收请求头部,客户端可继续发送请求体。该机制主要用于大体量请求(如上传大文件),避免在服务器拒绝请求时浪费带宽。
可能的原因
客户端在请求头中使用了 `Expect: 100-continue`,希望在发送请求体前由服务器确认
请求体可能很大(如文件上传),服务器需先验证头信息可接受
修复建议
无需特殊处理,使用该机制可优化上传流程的带宽使用
确保客户端正确设置了 `Expect` 请求头,服务器应按 RFC 返回 100 或最终状态码
若服务器不支持,可移除该头继续发送完整请求
101
Switching Protocols
服务器同意按照客户端 Upgrade 请求切换到另一协议(如 WebSocket、HTTP/2、HTTP/3)。切换后连接不再是普通 HTTP,会进入新的协议通道。
可能的原因
客户端发送带 `Connection: upgrade` 和 `Upgrade` 指定的协议(如 websocket)
服务器支持该协议并且同意切换至新协议
修复建议
确认客户端与服务器支持一致的协议与版本
验证握手头信息是否规范(如 Sec‑WebSocket‑Key、Sec‑WebSocket‑Protocol 等)
在切换失败时用正确的错误码(如 426 或 400)告知客户端
102
Processing
WebDAV 扩展状态码,表示服务器已接收完整请求并正在处理(如长时间生成报告),但尚无最终响应。该状态常用于预防客户端超时等待。
可能的原因
请求涉及长时间处理,如复杂查询、远程同步、文件写入等
服务器开启 WebDAV 并根据 RFC 自动发送 102,保持连接持续
修复建议
客户端应继续保持连接并等待最终响应
服务器应在处理完毕后发送最终状态码(如 200、207 等)
适合使用场景:批量任务、大文件处理、事务请求
103
Early Hints
服务器在最终响应前发出提示性头部(如 Link: preload),让浏览器提前加载资源,加速页面渲染。最终仍会发回 200/300+ 等响应。
可能的原因
服务器希望告诉浏览器可预加载 CSS/JS/图片等
通常与 HTTP/2 push 或浏览器预加载功能配合使用
修复建议
前端资源可根据提示头提前发起请求
无需特殊处理,浏览器自动处理该信息
服务器应最终发送完整响应,不应依赖早期提示完成所有内容
104
Upload Resumption Supported
由 IETF 草案定义(非正式标准)。
服务器使用该状态码表明支持断点续传上传机制,例如 HTTP-based resumable upload 协议,如 tus.io、Resumable.js 协议等。
可能的原因
客户端使用支持断点上传协议发起 HEAD 或 OPTIONS 请求
服务器为了声明支持上传续传功能,返回 104 作为提示
常用于大型文件上传、移动网络场景,避免上传中断造成资源浪费
修复建议
客户端检测 104 状态码作为是否启用断点续传的依据
上传失败时重用已上传部分,仅补传剩余部分
开发者可结合内容哈希或文件 ID 标识进行上传校验和续传断点定位
200
OK
请求已成功处理,并返回所请求的资源或操作结果。不同 HTTP 方法:
- GET: 返回请求资源
- POST/PUT/DELETE: 返回处理结果
- HEAD: 返回响应头,不返回主体内容
可能的原因
客户端请求语法、参数和 headers 完整且符合规范
服务器业务逻辑执行正常,无抛错
修复建议
无需进一步操作,表示业务已成功完成
前端可根据接口返回继续更新 UI 或状态
201
Created
请求已成功处理,并在服务器端创建了新资源。响应中通常包含 Location 头指向新资源地址,还可能返回资源内容。
可能的原因
客户端发起创建资源请求(如 POST /users)
服务器通过写数据库、存储建立资源成功
修复建议
前端可从 Location 获取新资源地址并跳转
也可根据返回内容刷新列表并提示创建成功
202
Accepted
服务器已接收请求并接受处理,但尚未完成执行。适用于异步操作或延迟处理场景,响应可能包含任务 ID 用于后续查询。
可能的原因
请求包含异步业务,如批量任务、导出、上传等
服务器将任务入队列,并未立即处理
修复建议
前端应定期轮询任务状态或订阅任务完成通知
显示 `处理中` 状态,处理完毕后更新 UI 或提示用户
203
Non-Authoritative Information
请求成功,但响应可能来自第三方代理,内容与原始资源不完全一致。通常用于代理缓存修改的场景。
可能的原因
客户端请求通过代理或 CDN,返回缓存内容
代理修改了响应内容后返回客户端
修复建议
验证内容准确性,必要时绕过缓存从源服务器获取
对缓存内容进行版本控制,保证一致性
204
No Content
服务器成功处理请求,但无需返回任何内容。适合无需刷新页面资源的场景,如表单提交、删除操作。
可能的原因
请求仅执行业务操作,无需返回数据
用于节省带宽,优化请求效率
修复建议
前端可根据逻辑刷新页面、清除表单或重置状态
避免返回空白响应体,保持状态更新可控
205
Reset Content
请求完成后,服务器请求客户端重置视图或布局。通常用于清空表单、复位编辑页。
可能的原因
表单提交后,需要清空输入框或重置页面内容
用于 `重复提交` 前重置 UI 结构
修复建议
前端应清空表单、重置组件状态
适用于单页应用需要重置编辑状态的场景
206
Partial Content
服务器响应了对资源的部分请求,常用于断点续传、媒体流加载。客户端通过 Range 请求部分内容实现分段处理。
可能的原因
客户端发出 Range 请求(如视频断点续传)
服务器支持 Range 并响应分段内容
修复建议
前端可拼接多个片段形成完整资源
适用于大文件下载、视频播放等断点逻辑
207
Multi-Status
WebDAV 扩展状态码,用于表述多个子请求状态。响应体以 XML 格式包含各项子请求执行结果。
可能的原因
批量操作请求如批量复制、删除多个资源
服务器支持 WebDAV 并返回多状态 XML
修复建议
解析 XML 中各项状态,处理成功/失败子项
适用于批量事务操作场景
208
Already Reported
WebDAV 避免重复返回已报告的成员状态,响应中不再枚举此前已列出资源,以减少冗余信息。
可能的原因
客户端请求集合资源的属性,服务器避免重复列出已报告成员
使用内部缓存或去重机制优化响应
修复建议
前端可忽略已报告条目,仅关注新成员
适合集合批量状态处理场景
226
IM Used
RFC 3229 定义状态码,表示请求已完成且响应为应用某种 `实例操作`(如差量编码、delta response)后的结果。
可能的原因
客户端支持 Delta Encoding 并发出相关请求
服务器按差异生成资源返回
修复建议
前端解析 delta:识别修改、删除、添加操作
适合缓存更新、带宽优化场景
300
Multiple Choices
服务器返回多个可用资源选项。
客户端应选择其中一个 URI,或在响应体中自动处理跳转。
可能的原因
请求资源存在多个可表示方式(如多语言、格式不同)
服务器希望客户端明确选择结果资源
修复建议
客户端自动选择最适合资源或使用 GUI 提示用户选择
若无需用户交互可设置明确的 Location 头来自动重定向
301
Moved Permanently
资源已永久迁移至新 URI。
客户端应更新引用记录,该响应可以被缓存,并建议未来使用新地址。
可能的原因
网站迁移到新的域名或目录结构发生改变
旧链接被用作 SEO 重定向方式
修复建议
更新书签、前端应用中引用的旧 URL
确保服务器返回 Location 头指向永久地址
利用 301 重定向压缩 SEO 链接权重
302
Found
资源临时从不同的 URI 返回。
客户端仍应使用原始 URL,服务器通常提供 Location 头进行临时跳转。
可能的原因
资源当前位置临时变更(如正在维护或重定位)
常用于登录后跳转或 A/B 页面切换
修复建议
客户端即刻跳转,但未来仍按原 URL 请求
确保 POST/PUT 请求不被错误地转换为 GET 请求
303
See Other
响应要求客户端使用 GET 方法到另一个 URI 获取资源,一般用做 POST 后的 redirect。
适用于避免重复提交。
可能的原因
表单提交后希望客户端重定向用户查看结果页面
防止刷新导致 POST 重发
修复建议
客户端在接收到 303 后用 GET 请求 Location 指定的URI
后端应在 Location 指明资源所在位置
304
Not Modified
资源自上次请求后未曾修改。
客户端可继续使用缓存版本,无需重新下载资源。
可能的原因
客户端发送 If-Modified-Since 或 If-None-Match 条件请求
服务器判断内容未变返回 304 以节省带宽
修复建议
客户端应使用本地缓存资源
前端可在请求失败或新内容则更新缓存
305
Use Proxy
请求必须通过指定代理访问资源。
该状态较为罕见,且现代浏览器大多忽略该代码。
可能的原因
服务器强制客户端使用特定代理来访问目的资源
常见于封闭网络或企业环境
修复建议
配置所需代理或通过服务器更新访问路径
现代 Web 应用建议不要使用该状态码
306
Switch Proxy (Unused)
该状态码已弃用,不再使用。
最初用于指示客户端切换代理服务器,现在保留为历史遗留。
可能的原因
历史遗留状态码,已无使用场景
修复建议
不应使用或依赖该状态码
如遇可忽略,不影响请求流程
307
Temporary Redirect
资源临时移动,客户端应保留请求方法(例如 POST 不变)并重发请求至 Location 指定 URI。
区别于 302 可保证方法不变。
可能的原因
资源临时重定位但不改变使用方式
用于升级版的短期重定向逻辑
修复建议
客户端应使用相同 HTTP 方法向新 URI 发送请求
确保 Location 指向正确位置
308
Permanent Redirect
永久重定向,客户端应保留请求方法并跳转到新 URI。
区别于 301,适合 REST API 的移动场景。
可能的原因
API endpoint 永久变化但方法需保留
服务器希望客户端记住请求方式与新地址
修复建议
客户端应使用相同 HTTP 方法向新 URL 重发请求
适合保留 POST/PUT 等语义的永久迁移
400
Bad Request
服务器无法理解请求。
常见于请求语法错误(如 JSON 格式不正确)、必填字段缺失、Content-Type 与实际体不匹配或 URL 格式不合法。
可能的原因
JSON、XML 等请求体解析失败
缺少必填参数或字段类型错误
Content-Type 与实际内容类型不一致
Query 参数未编码或格式异常
修复建议
使用开发工具检查请求体结构与字段
补齐字段、匹配类型、设置正确 Content-Type
对 URL 参数进行编码或修正
401
Unauthorized
身份验证失败。
客户端未提供有效凭证(如 token、cookie)或凭证已过期/无效,需要重新授权。
可能的原因
未提供 Authorization header 或 token
token 已过期、签名异常
Session、Cookie 失效
修复建议
提示用户登录或刷新授权凭证
在请求 header 中携带有效凭据
后端通过 WWW-Authenticate 引导认证流程
402
Payment Required
标准但保留为实验用途的状态码。
原意是用于在线支付场景,当资源需付费才能访问时返回。虽然已在 HTTP/1.1 中定义,但并未被广泛使用,部分现代平台用于 API 计费、订阅失效提示或支付失败等情境。
可能的原因
用户尝试访问需付费的内容或服务,但尚未付款
订阅服务过期或账户欠费
第三方 API 使用配额超出免费额度
部分平台用作 `软性封禁` 提示需升级付费
修复建议
引导用户完成支付流程或升级订阅计划
检查账户余额、信用卡状态或授权信息
API 调用方应根据错误处理跳转至付费页面或提示限额信息
开发者可结合响应 body 提示支付链接、订单编号等信息
403
Forbidden
服务器理解请求但拒绝执行。
身份已验证,但权限不足或被安全策略拒绝访问该资源。
可能的原因
用户角色不具备访问权限
资源受 ACL、IP 限制或安全策略保护
跨域请求未配置 CORS
修复建议
检查并开通用户访问权限
调整安全策略或 CORS 设置
使用账户拥有相应访问角色或资源
404
Not Found
请求的资源不存在。
可能因 API 接口变更、URL 拼写错误、资源已删除或路由/代理配置错误。
可能的原因
路径拼写错误或结构调整
资源已被删除未做重定向
反向代理或前端路由未正确转发
修复建议
检查 URL 拼写
设置资源迁移重定向方案(301/302)
调整路由/代理配置确保路径有效
405
Method Not Allowed
请求方法不被允许。
服务器识别该路径,但不支持当前 HTTP 方法(如 PUT 请求 GET-only 资源)。
可能的原因
使用了接口未支持的 HTTP 方法
后端路由/方法过滤配置未包含该方法
修复建议
查看接口文档使用合法方法
后端添加对应方法支持或更新路由
前端修正请求方式
406
Not Acceptable
客户端请求的质量不可接受。
请求的 Accept header 中声明了服务器无法提供的内容类型,如 image/avif 等。
可能的原因
Accept 与服务器响应类型不匹配
服务器不支持内容协商逻辑
Accept header 拼写或语法错误
修复建议
设置 Accept 为服务器支持的类型(如 application/json)
实现内容协商机制
确保 Accept header 格式正确
407
Proxy Authentication Required
代理访问需认证。
此标准码用于客户端需要在代理服务器提供认证凭证。
可能的原因
请求通过需认证的代理
缺少 Proxy-Authorization header
修复建议
为代理提供有效凭证
联系网络管理员获取认证信息
408
Request Timeout
服务器等待请求超时。
客户端未及时完成请求发送或网络延迟过高导致挂起。
可能的原因
网络延迟或不稳定
请求主体发送缓慢
服务器 timeout 设置偏短
修复建议
提高网络稳定性或重试连接
采用分片或压缩发送大体积请求
延长服务器与客户端 timeout 设置
409
Conflict
请求与当前资源状态冲突。
如并发修改资源、创建已存在唯一值、事务错误等情况。
可能的原因
并发操作导致版本冲突
重复创建存在资源(如用户名重复)
业务逻辑冲突导致异常
修复建议
使用乐观锁/版本号控制
检查资源是否存在后再创建
使用事务或幂等方法管理冲突
410
Gone
资源已永久删除,不再提供。
与 404 不同,此状态明确告知资源已废弃且不会迁移。
可能的原因
接口或资源被废弃
无可替代路径
修复建议
提示资源已下线或废弃
提供引导用户跳转替代方案
清理客户端中无效引用
411
Length Required
缺少 Content-Length。
服务器要求明确请求体长度,但客户端未设置或与实际不符。
可能的原因
请求头缺 Content-Length
长度设置与实际 body 不一致
修复建议
设置正确 Content-Length
使用 chunked encoding 或准确计算长度
412
Precondition Failed
前置条件失败。
通常用于 ETag、If-Match 等乐观锁控制条件校验失败。
可能的原因
ETag 或 If-Match 不匹配
资源在读取后被他人修改
修复建议
获取最新状态后重试
同步更新条件头进行乐观控制
413
Payload Too Large
请求主体过大。
超过服务器最大接受限制,通常用于上传大文件或大体积 JSON。
可能的原因
上传图像/视频等大文件超限
复杂 JSON 请求体过于庞大
修复建议
分片上传、压缩资源
增加服务器最大体积限制
前端预检大小再发送
414
URI Too Long
URI 长度过长。
包含过多参数的 GET 请求或循环重定向造成 URI 膨胀。
可能的原因
GET 请求参数过多
重定向链累积导致 URI 超长
修复建议
改为 POST 或请求体传参
避免嵌套拼接参数
清理循环重定向逻辑
415
Unsupported Media Type
媒体类型不支持。
通常指 Content-Type 与服务器不识别或不匹配。
可能的原因
Content-Type 与实际 body 不一致
服务器不支持该媒体类型
修复建议
使用正确匹配 Content-Type
扩展服务器支持所需格式
416
Range Not Satisfiable
Range 请求无效。
请求的范围超出资源内容长度或资源发生变化导致不匹配。
可能的原因
Range 范围超出资源长度
文件发生变动导致请求失效
修复建议
设置有效 Range 范围
重新获取资源长度后重试
417
Expectation Failed
服务器无法满足 Expect 请求头。
如 Expect:100-continue 不被支持时返回。
可能的原因
使用 Expect 而服务器不支持
Expect 头处理异常
修复建议
移除 Expect 头
启用服务器 Expect 支持
418
I'm a Teapot
由 IETF 在 RFC2324(愚人节 RFC)定义,仅作为玩笑。
用于表示'这是一个茶壶,不能煮咖啡',有时用于识别测试/爬虫请求,并非正式使用。
可能的原因
客户端请求对茶壶进行咖啡烹煮(HTCPCP)
开发者或服务器故意返回此状态用于检测/调试
修复建议
无需处理,仅作为彩蛋或测试用途
如用于封禁,可返回 403 替代
419
Authentication Timeout
Laravel 框架特定状态码。
表示用户认证超时,通常用于 CSRF 令牌失效或会话过期导致请求被拒绝。非官方标准,但广泛用于 web 应用。
可能的原因
CSRF 令牌过期或无效
用户登录会话超时
浏览器未携带或丢失认证 Cookie
修复建议
提示用户重新登录或刷新页面获取新令牌
前端确保每次请求携带有效的 CSRF token
调整服务器会话过期时间以满足需求
420
Method Failure
Spring Framework (WebDAV) 特定状态码。
表示请求方法执行失败,通常用于 WebDAV 开发中,代表部分资源操作未能成功完成。不是官方 HTTP 标准状态码。
可能的原因
请求方法本身语法正确但执行失败
资源状态或权限导致操作不成功
部分 WebDAV 操作冲突或失败
修复建议
检查资源状态及权限配置
确保 WebDAV 服务正确处理请求方法
增强错误日志方便排查具体失败原因
421
Misdirected Request
请求被发向错误服务器。
多用于 HTTP/2,有多个域共用同一 IP,但没有路由支持的情况。
可能的原因
TLS SNI 指向服务器不支持该 Host
不同域名共用一个 IP 且未路由区分
修复建议
配置正确 TLS SNI 与域名绑定
确保 HTTP/2 多域名服务支持 Host 区分
422
Unprocessable Entity
请求语法正确但语义错误。
常用于表单/JSON 参数校验失败,例如缺字段或值非法。
可能的原因
必填字段丢失或类型异常
字段值不满足业务校验
修复建议
前端校验并补齐字段
遵循 API 规范提交合法内容
423
Locked
资源被锁定。
用于 WebDAV,当资源正被另一个请求修改或锁定中使用。
可能的原因
资源锁被持有
其他用户/系统修改中
修复建议
等待锁释放
释放锁或限制并发访问
424
Failed Dependency
依赖请求失败导致当前请求失败。
常用于 WebDAV 事务场景,一步失败则后续请求失败。
可能的原因
事务中前置操作失败
关联请求链未完全执行
修复建议
检查链中先前步骤状态
分解流程并重试失败步骤
425
Too Early
服务器拒绝过早请求。
防止客户端在 TLS 握手完成之前发送请求,可能造成重放攻击。
可能的原因
客户端使用早期数据发送请求
浏览器或请求库支持 0-RTT 请求策略
修复建议
等待 TLS 握手完成再发起请求
禁用早期请求功能
426
Upgrade Required
要求切换协议。
如强制 TLS 或 HTTP/2,以提高安全性或性能。
可能的原因
客户端使用不安全或老旧协议
后端要求升级连接协议
修复建议
使用 https 或 TLS/2 等协议调用
服务器可提供 Upgrade 提示 header
428
Precondition Required
服务器要求带条件请求头。
用于防止盲写覆盖资源,避免 Lost Update。
可能的原因
资源现需条件头才能执行写操作
乐观锁保护未启用
修复建议
在写请求中添加 If-Match 或 If-Unmodified-Since
确保请求满足前置条件
429
Too Many Requests
发送请求过于频繁,触发限流策略。
通常服务器会设置 Retry-After 提示可重试时间。
可能的原因
客户端短时间内并发或频繁调用接口
IP 或用户达到配额限制
修复建议
遵循 Retry-After 头进行重试
引入指数退避机制
视情况提高配额或限制并发请求
430
Request Header Fields Too Large
Shopify 自定义状态码。
表示请求头字段太大,超过服务器允许的大小限制,通常因 Cookie 或自定义 Header 过多导致请求被拒绝。
可能的原因
请求携带大量 Cookie 或长值
自定义请求头过多或内容冗长
请求头数据膨胀超过服务器处理能力
修复建议
清理或缩减请求中的 Cookie 和 Header
优化客户端请求,减少不必要的头信息
增加服务器允许的请求头大小限制(若可行)
431
Request Header Fields Too Large
请求头域数据过大。
常因 Cookie 膨胀、自定义 header 过多或循环堆积导致。
可能的原因
Cookie 数量或内容过多
重复 header 或 header 内容过长
修复建议
清理无用 Cookie
减少 header 字段数量
对 header 做合理拆分
444
No Response
由 Nginx 定义的非标准状态码。
服务器接收请求后立即关闭连接,未返回任何内容,以防止恶意或不良采集请求。
可能的原因
Nginx 配置使用 return 444 拦截指定请求
防爬虫、恶意扫描策略触发
修复建议
确认拦截配置是否精准
分析日志判断是否误杀合法访问
设置白名单避免误拦
449
Retry With
Microsoft IIS 自定义状态码。
表示请求因某些条件失败,客户端需要修改请求后重试。常用于代理或服务器需要客户端调整请求头或参数的场景。
可能的原因
请求缺少必要的头信息或参数
请求格式不符合服务器要求
服务器期望客户端调整请求再发送
修复建议
根据服务器响应提示调整请求内容
补充缺失的请求头或参数
重试请求,确保符合服务器要求
450
Blocked by Windows Parental Controls
Microsoft IIS 自定义状态码。
表示请求被 Windows 家长控制策略阻止访问,常见于家庭网络或企业限制环境。
可能的原因
请求目标被家长控制策略屏蔽
访问被限制的网站或内容
用户账户权限受限
修复建议
联系网络管理员解除限制
调整家长控制设置允许访问
使用无权限限制的账户访问资源
451
Unavailable For Legal Reasons
资源被法律强制屏蔽。
如因版权、审查或法院令而禁止访问。
可能的原因
版权争议导致资源下架
政府机关或法院要求封禁
修复建议
提示法律原因,不要触犯
提供替代信息或合法访问路径
494
Request Header Too Large
由 Nginx 定义的非标准状态码。
表示请求头部字段或总大小超过服务器配置的限制,服务器拒绝处理该请求。
可能的原因
请求携带过多或过大的 Cookie
自定义请求头冗余或体积过大
客户端错误导致头部膨胀
修复建议
清理或减少请求中的 Cookie 和 Header
优化请求头大小,避免冗余
调整 Nginx 配置中 client_header_buffer_size 和 large_client_header_buffers
495
SSL Certificate Error
由 Nginx 定义。
客户端提交了无效或不信任的 SSL 证书,连接被拒绝。
可能的原因
客户端 SSL 证书签名错误或过期
证书链不完整或域名不匹配
修复建议
使用有效可信证书
配置完整证书链
496
SSL Certificate Required
Nginx 定义。
客户端未提供必需的 SSL 证书,但服务器配置为双向认证。
可能的原因
开启双向 TLS 但客户端无证书
SSL handshake 中未携带证书
修复建议
附加合法客户端证书
或关闭双向认证要求
497
HTTP Request Sent to HTTPS Port
Nginx 定义。
客户端错误地使用 HTTP 协议访问 HTTPS 端口,协议不匹配。
可能的原因
使用 http:// 而非 https:// 访问 443 端口
URL 配置或端口错误
修复建议
使用 https 协议访问
修正前端/代理 URL 配置
498
Invalid Token
由 Esri ArcGIS Server 定义。
表示客户端 token 无效、已被撤销或格式错误,区别于通用 401。
可能的原因
token 签名验证失败或过期
token 格式不符合服务要求
修复建议
重新登录或刷新 token
后端返回详细错误帮助定位
499
Client Closed Request
由 Nginx 和 Esri ArcGIS Server 定义的非标准状态码。
表示客户端在服务器返回响应之前主动关闭了连接。
常见于用户取消请求、网络波动或移动端频繁切换网络。
可能的原因
用户主动停止页面加载或取消请求
移动网络切换或断开导致连接关闭
前端请求超时或网络中断
修复建议
优化接口响应速度,减少阻塞
前端加入请求超时和重试机制
监控 499 状态码频率,判断是否为异常网络
500
Internal Server Error
标准 HTTP/1.0 服务器错误。
表示服务器遇到意外情况无法完成请求。
可能的原因
后端代码抛出未捕获异常
数据库连接中断或执行失败
第三方 API 响应错误
修复建议
检查并完善异常捕获机制
优化数据库连接池与重试逻辑
添加错误日志和告警监控
501
Not Implemented
标准 HTTP/1.1。
表示请求方法服务器不支持,如 PUT、PATCH 或自定义方法未实现。
可能的原因
服务器未实现客户端请求中使用的 HTTP 方法
请求策略超出服务器能力范围
修复建议
参考 API 文档使用有效方法
服务器实现对应功能或返回 405
502
Bad Gateway
标准 HTTP/1.1。
作为网关或代理时,从上游服务器收到无效响应。
可能的原因
上游服务器返回格式异常内容或错误响应
网关连接设置或超时配置不正确
修复建议
检查网关与上游连接配置
增加超时或重试机制
修正上游服务接口问题
503
Service Unavailable
标准 HTTP/1.1。
服务器当前无法处理请求,可能因过载、维护或资源不足。
可能的原因
服务器过载,如过高 QPS 或资源争用
服务正在维护或重启
系统资源(CPU/内存)耗尽
修复建议
做健康检查与分流请求
使用灰度部署避免版本冲突
增加服务器资源或限流措施
504
Gateway Timeout
标准 HTTP/1.1。
作为网关或代理时,上游服务器在所设置的等待时间内未作出响应。
可能的原因
上游服务处理时间过长或死锁
网络延迟或连接问题
代理/负载均衡超时设置过短
修复建议
排查上游性能瓶颈或死锁问题
合理设置超时时长
优化网络连接稳定性
505
HTTP Version Not Supported
标准 HTTP/1.1。
服务器不支持客户端所指定的 HTTP 协议版本。
可能的原因
客户端使用了不受支持的 HTTP 版本,如 HTTP/2 协议调用 HTTP/1.0 服务
修复建议
客户端使用受支持的协议版本
服务器可返回升级提示或兼容处理
506
Variant Also Negotiates
WebDAV 扩展状态码(RFC 2295)。
表示服务器配置了内容协商的变体代理,但代理自身也参与内容协商,导致循环依赖,无法完成请求。
可能的原因
服务器配置内容协商时错误地包含自身为变体
代理服务器或中间件配置循环导致协商环路
错误的多层代理设置造成请求循环
修复建议
检查服务器内容协商配置,避免代理自身参与协商
调整代理层配置,防止循环调用
优化多层代理链条,确保请求正确转发
507
Insufficient Storage
WebDAV 扩展(RFC4918)。
服务器无法存储完成请求所必需的内容,如磁盘空间不足。
可能的原因
磁盘空间用尽
资源写入失败
修复建议
清理磁盘空间或扩展存储
检测写入错误并提示用户
508
Loop Detected
WebDAV 扩展(RFC5842)。
服务器检测到一个内部资源循环引用,导致操作无限递归。
可能的原因
资源引用路径出现环路
循环依赖未被防范
修复建议
检测并消除配置中的循环引用
添加循环保护机制
509
Bandwidth Limit Exceeded
由 Apache 和 cPanel 定义的自定义状态码。
表示服务器带宽限制已达到,暂时拒绝请求以防止过载。
可能的原因
服务器带宽用尽或接近上限
流量峰值导致服务器过载
修复建议
联系主机服务商提升带宽限制
优化内容交付策略,减少流量峰值
使用 CDN 分担流量压力
510
Not Extended
HTTP 扩展状态码(RFC 2774),用于指示客户端请求缺少必要的扩展信息,服务器无法完成请求。
该状态码已被废弃,不建议使用。
可能的原因
客户端未包含必需的扩展请求头或参数
服务器要求额外的协议扩展支持
修复建议
确保客户端请求包含所有必需的扩展信息
避免使用已废弃的协议扩展或迁移至新协议
511
Network Authentication Required
标准状态码(RFC 6585)。
表示客户端需对网络进行认证,常见于 Captive Portal 认证场景,如公共 Wi-Fi 登录页面。
可能的原因
用户尚未通过网络门户认证
网络访问受限,需身份验证
修复建议
引导用户完成网络认证流程
允许 Captive Portal 页面访问
管理员配置认证系统正常运行
520
Web Server Returned Unknown Error
由 Cloudflare 定义的自定义状态码。
表示源服务器返回了一个未知的错误或空响应,导致 Cloudflare 无法正确响应客户端请求。
可能的原因
源服务器崩溃或异常关闭连接
返回了无效或空的 HTTP 响应
修复建议
检查源服务器日志排查异常
确保服务器正确处理请求并返回有效响应
521
Web Server Is Down
Cloudflare 自定义。
表示 Cloudflare 无法连接到源服务器,源服务器关闭或拒绝连接。
可能的原因
源服务器宕机或不可达
防火墙阻止 Cloudflare IP
修复建议
确认源服务器在线并监听请求
配置防火墙允许 Cloudflare 访问
522
Connection Timed Out
Cloudflare 自定义。
表示 Cloudflare 与源服务器 TCP 连接成功,但源服务器未在规定时间内响应。
可能的原因
源服务器响应缓慢
网络延迟或阻塞
修复建议
优化服务器性能
调整超时设置
523
Origin Is Unreachable
Cloudflare 自定义。
表示 Cloudflare 无法通过 DNS 解析访问源服务器,导致请求失败。
可能的原因
DNS 解析错误或配置异常
源服务器网络不可达
修复建议
检查 DNS 记录正确性
确保源服务器网络正常
524
A Timeout Occurred
Cloudflare 自定义。
表示 Cloudflare 成功建立连接,但在超时时间内未从源服务器收到完整响应。
可能的原因
源服务器处理请求超时
长时间阻塞操作
修复建议
优化服务器处理逻辑
避免长时间阻塞请求
525
SSL Handshake Failed
Cloudflare 自定义。
表示 Cloudflare 与源服务器的 SSL 握手失败,通常因证书无效或配置不当。
可能的原因
源服务器 SSL 证书无效或过期
协议不兼容或配置错误
修复建议
安装有效 SSL 证书
配置正确的 TLS 版本
526
Invalid SSL Certificate
Cloudflare 自定义。
表示源服务器提供了无效或不被信任的 SSL 证书。
可能的原因
证书已过期、签名错误或不被信任
修复建议
更新并安装有效证书
确保证书链完整
527
Railgun Error
Cloudflare 自定义,Railgun 服务相关。
表示 Cloudflare 与源服务器之间的 Railgun 通信错误。
可能的原因
Railgun 服务不可用或配置错误
版本不兼容
修复建议
检查 Railgun 服务状态
更新或重置 Railgun 配置
529
Site Is Overloaded
由 Qualys SSL Labs 定义的非标准状态码。
表示服务器因过载无法处理请求。
可能的原因
服务器资源被耗尽
访问请求过多导致拥堵
修复建议
扩容服务器资源
实施流量控制和负载均衡
530
Site Is Frozen
由 Pantheon 定义的自定义状态码。
表示网站因违反政策被冻结,无法访问。
可能的原因
违反服务条款
被暂停或冻结服务
修复建议
联系服务提供商解决问题
遵守平台政策恢复服务
531
Reserved / Vendor-specific
常见为 CDN、云服务商或厂商预留的状态码。
具体含义取决于服务提供商,未被 IANA 或 IETF 正式注册。
可能的原因
厂商根据自身产品设计特定状态码
多用于自定义错误、流量控制、访问限制等
部分码段为 AWS ELB、Cloudflare、Akamai 等专属
修复建议
查阅对应厂商文档获取详细定义
根据具体错误信息和日志进行排查
联系服务商技术支持确认处理方案
532
Reserved / Vendor-specific
同上,属于厂商保留代码范围,具体含义依厂商而异。
可能的原因
见 531 状态码说明
修复建议
见 531 状态码说明
533
Reserved / Vendor-specific
同上。
可能的原因
见 531 状态码说明
修复建议
见 531 状态码说明
534
Reserved / Vendor-specific
同上。
可能的原因
见 531 状态码说明
修复建议
见 531 状态码说明
535
Reserved / Vendor-specific
同上。
可能的原因
见 531 状态码说明
修复建议
见 531 状态码说明
536
Reserved / Vendor-specific
同上。
可能的原因
见 531 状态码说明
修复建议
见 531 状态码说明
537
Reserved / Vendor-specific
同上。
可能的原因
见 531 状态码说明
修复建议
见 531 状态码说明
538
Reserved / Vendor-specific
同上。
可能的原因
见 531 状态码说明
修复建议
见 531 状态码说明
599
Network Connect Timeout
非标准代理错误码。
表示代理服务器尝试连接上游服务器时发生超时。
可能的原因
上游服务器不可达
网络连接延迟或故障
修复建议
检查网络连接和代理配置
增加连接超时时间
关于我的工具箱
我们致力于为您提供高效、便捷的在线工具,让工作和生活更加智能化。
ICP备案/许可证号:
京ICP备18008190号-3
隐私政策