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