100 Continue
服务器已收到初始请求头,客户端可以继续发送请求体内容。
提示: 常见于携带 Expect: 100-continue 请求头的大文件上传场景。
搜索 1xx–5xx HTTP 状态码含义与 API/CDN 调试建议。
服务器已收到初始请求头,客户端可以继续发送请求体内容。
提示: 常见于携带 Expect: 100-continue 请求头的大文件上传场景。
服务器同意按请求升级连接协议,最常见是从 HTTP 升级到 WebSocket。
提示: 如果 WebSocket 握手卡住,请检查 Upgrade 和 Connection 请求头是否被代理剥离。
标准成功响应,表明 HTTP 请求已被正常处理并返回结果。
提示: 若客户端仍解析异常,请检查响应头 Content-Type 及返回的 JSON 结构。
请求已成功处理,并在服务端创建了一项或多项新资源。
提示: REST 接口通常会同时返回指向新建资源地址的 Location 响应头。
请求已成功处理,服务器刻意不返回任何响应体。
提示: 遇到 204 响应(常见于 DELETE 或 CORS OPTIONS 预检)切勿调用 response.json()。
服务器仅返回客户端在 Range 请求头中指定的部分字节区间内容。
提示: 广泛应用于视频进度条拖动播放以及大文件的断点续传。
目标资源已永久迁移至新 URL,搜索引擎会将权重转移至新地址。
提示: 浏览器对 301 会强缓存——调试新跳转规则请用无痕模式或 curl -I。
资源临时从另一地址提供,原 URL 仍应保留在索引中。
提示: 常见于 OAuth 第三方登录回跳或临时维护分流。
根据 ETag 或 Last-Modified 校验,本地缓存副本仍然有效。
提示: 可显著节省静态资源流量;若出现旧版缓存未更新请检查 Cache-Control。
临时重定向,严格保留原请求的 HTTP 方法与请求体不改写。
提示: 当 POST 请求在跳转后仍须保持为 POST 时,应使用 307 而非 302。
永久重定向,严格保留原请求的 HTTP 方法与请求体不改写。
提示: 常见于 Next.js 末尾斜杠规范化跳转及全站强制 HTTPS。
由于请求语法错误或参数格式无效,服务器无法解析处理该请求。
提示: 重点检查 JSON 语法、必填查询参数以及 Content-Type 请求头。
访问受保护接口时缺少身份凭证,或令牌已过期、签名无效。
提示: 排查 Authorization Bearer 令牌有效期、API Key 前缀或会话 Cookie。
客户端身份已知或命中安全策略,但缺乏访问目标资源的权限。
提示: 检查 RBAC 角色权限、CORS/WAF 防火墙策略以及存储桶读写权限。
服务器未能找到客户端所请求的路由地址或目标资源。
提示: 核对路径末尾斜杠、basePath 前缀、DNS 路由规则或已删除的资源 ID。
该接口路径存在,但不支持当前使用的 HTTP 请求方法(如 GET 误用为 POST)。
提示: 查看响应头 Allow 中列出的服务端允许方法。
客户端发送完整请求耗时过长,服务器主动关闭了超时连接。
提示: 排查弱网环境下大文件上传超时或客户端与代理之间的 Keep-Alive 配置不一致。
当前请求与目标资源的现有状态存在业务或版本冲突。
提示: 常见于邮箱重复注册,或乐观锁更新时 ETag 版本不匹配。
请求体大小超过了源站或反向代理设置的最大允许体积上限。
提示: 上传前先在浏览器端压缩图片体积,或调大网关的请求体大小限制。
服务器拒绝接受请求头 Content-Type 中声明的数据载荷格式。
提示: 确认发送体与 Content-Type: application/json 或 multipart/form-data 一致。
请求体语法合法(例如为合法 JSON),但字段值未通过业务语义校验。
提示: 查看错误详情,排查邮箱格式不符、负数金额或非法枚举值。
客户端触发了 API 速率限制(Rate Limit)或突发并发配额上限。
提示: 按响应头 Retry-After 等待,并在重试中结合指数退避与随机抖动(jitter)。
源站服务器在处理请求时发生未捕获的内部异常。
提示: 检查后端异常堆栈日志、缺失环境变量或数据库连接异常。
反向代理、CDN 或负载均衡器从上游应用服务器收到了无效响应。
提示: 确认上游服务进程是否正常运行且正在监听正确端口。
服务器当前过载或处于计划内停机维护状态,暂时无法提供服务。
提示: 关注 Retry-After 重试等待头、健康检查失败原因或冷启动资源耗尽。
代理或 CDN 在等待上游服务器返回响应时发生网关超时。
提示: 优化慢速数据库查询,或将耗时任务转为异步后台队列处理。
| 代码 | 名称 | 含义 | 调试建议 | 复制 |
|---|---|---|---|---|
| 100 | 100 Continue | 服务器已收到初始请求头,客户端可以继续发送请求体内容。 | 常见于携带 Expect: 100-continue 请求头的大文件上传场景。 | |
| 101 | 101 Switching Protocols | 服务器同意按请求升级连接协议,最常见是从 HTTP 升级到 WebSocket。 | 如果 WebSocket 握手卡住,请检查 Upgrade 和 Connection 请求头是否被代理剥离。 | |
| 200 | 200 OK | 标准成功响应,表明 HTTP 请求已被正常处理并返回结果。 | 若客户端仍解析异常,请检查响应头 Content-Type 及返回的 JSON 结构。 | |
| 201 | 201 Created | 请求已成功处理,并在服务端创建了一项或多项新资源。 | REST 接口通常会同时返回指向新建资源地址的 Location 响应头。 | |
| 204 | 204 No Content | 请求已成功处理,服务器刻意不返回任何响应体。 | 遇到 204 响应(常见于 DELETE 或 CORS OPTIONS 预检)切勿调用 response.json()。 | |
| 206 | 206 Partial Content | 服务器仅返回客户端在 Range 请求头中指定的部分字节区间内容。 | 广泛应用于视频进度条拖动播放以及大文件的断点续传。 | |
| 301 | 301 Moved Permanently | 目标资源已永久迁移至新 URL,搜索引擎会将权重转移至新地址。 | 浏览器对 301 会强缓存——调试新跳转规则请用无痕模式或 curl -I。 | |
| 302 | 302 Found | 资源临时从另一地址提供,原 URL 仍应保留在索引中。 | 常见于 OAuth 第三方登录回跳或临时维护分流。 | |
| 304 | 304 Not Modified | 根据 ETag 或 Last-Modified 校验,本地缓存副本仍然有效。 | 可显著节省静态资源流量;若出现旧版缓存未更新请检查 Cache-Control。 | |
| 307 | 307 Temporary Redirect | 临时重定向,严格保留原请求的 HTTP 方法与请求体不改写。 | 当 POST 请求在跳转后仍须保持为 POST 时,应使用 307 而非 302。 | |
| 308 | 308 Permanent Redirect | 永久重定向,严格保留原请求的 HTTP 方法与请求体不改写。 | 常见于 Next.js 末尾斜杠规范化跳转及全站强制 HTTPS。 | |
| 400 | 400 Bad Request | 由于请求语法错误或参数格式无效,服务器无法解析处理该请求。 | 重点检查 JSON 语法、必填查询参数以及 Content-Type 请求头。 | |
| 401 | 401 Unauthorized | 访问受保护接口时缺少身份凭证,或令牌已过期、签名无效。 | 排查 Authorization Bearer 令牌有效期、API Key 前缀或会话 Cookie。 | |
| 403 | 403 Forbidden | 客户端身份已知或命中安全策略,但缺乏访问目标资源的权限。 | 检查 RBAC 角色权限、CORS/WAF 防火墙策略以及存储桶读写权限。 | |
| 404 | 404 Not Found | 服务器未能找到客户端所请求的路由地址或目标资源。 | 核对路径末尾斜杠、basePath 前缀、DNS 路由规则或已删除的资源 ID。 | |
| 405 | 405 Method Not Allowed | 该接口路径存在,但不支持当前使用的 HTTP 请求方法(如 GET 误用为 POST)。 | 查看响应头 Allow 中列出的服务端允许方法。 | |
| 408 | 408 Request Timeout | 客户端发送完整请求耗时过长,服务器主动关闭了超时连接。 | 排查弱网环境下大文件上传超时或客户端与代理之间的 Keep-Alive 配置不一致。 | |
| 409 | 409 Conflict | 当前请求与目标资源的现有状态存在业务或版本冲突。 | 常见于邮箱重复注册,或乐观锁更新时 ETag 版本不匹配。 | |
| 413 | 413 Content Too Large | 请求体大小超过了源站或反向代理设置的最大允许体积上限。 | 上传前先在浏览器端压缩图片体积,或调大网关的请求体大小限制。 | |
| 415 | 415 Unsupported Media Type | 服务器拒绝接受请求头 Content-Type 中声明的数据载荷格式。 | 确认发送体与 Content-Type: application/json 或 multipart/form-data 一致。 | |
| 422 | 422 Unprocessable Content | 请求体语法合法(例如为合法 JSON),但字段值未通过业务语义校验。 | 查看错误详情,排查邮箱格式不符、负数金额或非法枚举值。 | |
| 429 | 429 Too Many Requests | 客户端触发了 API 速率限制(Rate Limit)或突发并发配额上限。 | 按响应头 Retry-After 等待,并在重试中结合指数退避与随机抖动(jitter)。 | |
| 500 | 500 Internal Server Error | 源站服务器在处理请求时发生未捕获的内部异常。 | 检查后端异常堆栈日志、缺失环境变量或数据库连接异常。 | |
| 502 | 502 Bad Gateway | 反向代理、CDN 或负载均衡器从上游应用服务器收到了无效响应。 | 确认上游服务进程是否正常运行且正在监听正确端口。 | |
| 503 | 503 Service Unavailable | 服务器当前过载或处于计划内停机维护状态,暂时无法提供服务。 | 关注 Retry-After 重试等待头、健康检查失败原因或冷启动资源耗尽。 | |
| 504 | 504 Gateway Timeout | 代理或 CDN 在等待上游服务器返回响应时发生网关超时。 | 优化慢速数据库查询,或将耗时任务转为异步后台队列处理。 |
搜索 1xx–5xx HTTP 状态码含义与 API/CDN 调试建议。
401 表示未通过身份认证(缺少或过期的登录凭证),403 表示身份已识别但没有权限访问目标资源。
两者都表示网关/CDN 与上游源站服务器通信失败(502 为上游返回无效响应,504 为上游响应超时)。