深量

HTTP 状态码查询

按类别整理 1xx 至 5xx 常用状态码,包含标准名称、中文含义与处理建议,支持按状态码或名称实时搜索。

共收录 62 个常用状态码
1xx 信息响应4 个
状态码名称含义处理建议
100Continue服务器已收到请求头,客户端可以继续发送请求体。客户端等待 100 响应后再发送正文,无需额外处理。
101Switching Protocols服务器根据 Upgrade 请求头切换协议。常见于 WebSocket 升级,检查代理是否透传 Upgrade 头。
102Processing服务器已收到并正在处理请求,暂时没有结果(WebDAV)。长耗时任务可返回此码,避免客户端超时断开。
103Early Hints在最终响应前提前提示客户端预加载资源。配合 Link 响应头预加载关键资源,缩短首屏时间。
2xx 成功10 个
状态码名称含义处理建议
200OK请求成功,响应体包含请求的结果。正常返回数据,保持响应结构稳定。
201Created请求成功并创建了新的资源。通过 Location 头返回新资源的访问地址。
202Accepted请求已被接受,但尚未处理完成。适用于异步任务,返回任务 ID 供后续查询。
203Non-Authoritative Information返回的元信息来自副本而非源服务器。一般较少使用,确认是否需要代理改写响应。
204No Content请求成功,但没有响应体。常用于删除、更新后无需返回数据的场景。
205Reset Content要求客户端重置文档视图。表单提交后可返回此码清空输入。
206Partial Content返回资源的部分内容,用于断点续传或分片下载。检查 Range 请求头与 Content-Range 响应头是否正确。
207Multi-Status批处理中每个子请求可能返回不同状态(WebDAV)。解析响应体中的各子请求状态,分别处理。
208Already Reported同一集合成员已在之前的状态中报告过(WebDAV)。避免重复返回相同的成员信息。
226IM Used服务器已完成对资源的增量修改。较少使用,确认客户端是否支持增量更新。
3xx 重定向8 个
状态码名称含义处理建议
300Multiple Choices请求对应多个可选资源。返回候选列表,由客户端或用户选择目标。
301Moved Permanently资源已永久迁移到新的 URL。更新站内链接并使用 301 跳转,传递搜索权重。
302Found资源临时位于其他 URL。用于临时跳转,避免长期依赖;注意浏览器可能将 POST 转为 GET。
303See Other应使用 GET 访问另一个 URL 获取结果。表单提交后重定向到结果页,避免刷新重复提交。
304Not Modified命中协商缓存,资源自上次请求后未变化。检查 ETag / Last-Modified 与 Cache-Control 配置。
305Use Proxy必须通过指定代理访问资源(已废弃)。出于安全考虑,不建议使用。
307Temporary Redirect临时重定向,且保持原请求方法不变。需要保留 POST 等方法的临时跳转优先使用 307。
308Permanent Redirect永久重定向,且保持原请求方法不变。需要保留方法的永久跳转使用 308。
4xx 客户端错误29 个
状态码名称含义处理建议
400Bad Request请求语法或参数有误,服务器无法理解。校验参数格式、请求体与字符编码,返回明确的错误信息。
401Unauthorized缺少或提供了无效的身份凭证。引导用户登录,或携带有效的 Token / Cookie 后重试。
402Payment Required保留状态码,多用于需要付费的接口。按业务规则提示用户完成付费或开通。
403Forbidden身份已认证,但没有权限访问该资源。检查账号角色、IP 白名单与文件访问权限。
404Not Found请求的资源不存在。检查 URL、路由与资源是否被删除,并配置友好的 404 页面。
405Method Not Allowed请求方法不被目标资源支持。查看 Allow 响应头,改用正确的 GET / POST 等方法。
406Not Acceptable无法满足 Accept 头要求的响应格式。调整 Accept 头,或检查服务端内容协商逻辑。
407Proxy Authentication Required需要先通过代理服务器认证。配置正确的代理账号与密码。
408Request Timeout客户端未在服务器规定时间内完成请求。检查客户端网络与服务端超时设置。
409Conflict请求与资源当前状态冲突,例如重复创建。处理并发与唯一性冲突,返回冲突的具体原因。
410Gone资源已被永久删除且不再可用。返回 410 并清理站内链接,比 404 表达更明确。
411Length Required请求缺少 Content-Length 头。补全请求头,或改用分块传输。
412Precondition FailedIf-Match 等前置条件不满足。检查 ETag 与并发版本后再重试。
413Content Too Large请求体超过服务器允许的大小限制。压缩或分段上传,并合理调整服务端限制。
414URI Too Long请求的 URL 长度超过服务器限制。缩短查询参数,或改用 POST 提交数据。
415Unsupported Media Type请求体格式不受服务器支持。设置正确的 Content-Type,并确认服务端已支持该格式。
416Range Not SatisfiableRange 请求的范围超出资源大小。校验 Content-Range 与文件实际长度。
417Expectation Failed无法满足 Expect 请求头的要求。移除 Expect 头,或检查中间代理的兼容性。
418I'm a teapot愚人节彩蛋状态码(RFC 2324),并非正式业务状态。仅作趣味用途,不要在业务逻辑中使用。
421Misdirected Request请求被发送到无法响应的服务器。检查 HTTP/2 连接复用与 SNI 配置。
422Unprocessable Content请求语法正确,但语义校验失败。返回字段级的校验错误,便于前端定位。
423Locked目标资源被锁定(WebDAV)。解除锁定或等待锁释放后重试。
424Failed Dependency因前置请求失败导致当前请求失败(WebDAV)。排查上游依赖与批处理的执行顺序。
425Too Early服务器不愿处理可能被重放的早期请求。适当延迟后重试该请求。
426Upgrade Required客户端需要升级协议后才能访问资源。按 Upgrade 响应头切换协议,例如升级到 TLS。
428Precondition Required服务器要求请求携带前置条件,避免更新丢失。使用 If-Match 等条件请求头。
429Too Many Requests请求过于频繁,触发了限流。降低请求频率,并按 Retry-After 提示的时间重试。
431Request Header Fields Too Large请求头总长度超过服务器限制。精简 Cookie 与自定义请求头,或增大限制。
451Unavailable For Legal Reasons因法律要求无法提供该资源。说明不可用的原因,并按合规要求处理。
5xx 服务器错误11 个
状态码名称含义处理建议
500Internal Server Error服务器处理请求时发生未预期的错误。查看服务端日志与异常堆栈,修复后发布;对外返回友好提示。
501Not Implemented服务器不支持该请求方法。实现对应方法,或改为返回 405 并给出 Allow 头。
502Bad Gateway网关或代理从上游服务收到无效响应。检查上游服务状态、反向代理配置与连接超时。
503Service Unavailable服务器暂时无法处理请求,通常是过载或维护。返回 Retry-After,扩容实例或等待维护完成。
504Gateway Timeout网关等待上游服务响应超时。检查上游性能、慢查询与代理超时设置。
505HTTP Version Not Supported服务器不支持请求使用的 HTTP 版本。改用受支持的 HTTP 版本发起请求。
506Variant Also Negotiates内容协商配置错误,导致变体之间循环协商。检查服务端的内容协商配置。
507Insufficient Storage服务器无法存储完成请求所需的内容(WebDAV)。清理或扩容存储空间后重试。
508Loop Detected服务器检测到处理过程中的无限循环(WebDAV)。检查目录链接与重定向链路。
510Not Extended需要对请求进行进一步扩展才能完成。检查扩展协议与相关配置。
511Network Authentication Required客户端需要完成网络认证,例如公共 WiFi 登录。完成网络认证后重新访问。

状态码由三位数字组成:第一位表示响应类别,后两位用于区分具体语义。RFC 9110 将 1xx 至 5xx 定义为标准类别,部分状态码来自 WebDAV 等扩展规范;排查线上问题时,应结合响应体、日志与服务端配置综合判断。