WebGroundwebground.app
信息与指南 · Web 参考

HTTP 状态码与调试参考

搜索 1xx–5xx HTTP 状态码含义与 API/CDN 调试建议。

显示 26 个状态码
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 在等待上游服务器返回响应时发生网关超时。

提示: 优化慢速数据库查询,或将耗时任务转为异步后台队列处理。

正在调试 API 响应?可配合使用JSON 格式化工具

HTTP 状态码与调试参考

搜索 1xx–5xx HTTP 状态码含义与 API/CDN 调试建议。

  • HTTP 请求已被服务器成功接收并处理。
  • 客户端请求参数有误、缺少认证凭证、路径不存在或触发限流。
  • 服务端内部异常、上游服务不可用或网关超时。

常见问题 (FAQ)

HTTP 401 和 403 有什么区别?+

401 表示未通过身份认证(缺少或过期的登录凭证),403 表示身份已识别但没有权限访问目标资源。

502 Bad Gateway 和 504 Gateway Timeout 是什么意思?+

两者都表示网关/CDN 与上游源站服务器通信失败(502 为上游返回无效响应,504 为上游响应超时)。

探索更多 WebGround 工具

查看全部