HTTP 状态码开发

HTTP 状态码速查表

⌘K

1xx

Informational

4 个

状态码	名称	描述
	Continue	服务器已收到请求头，客户端应继续发送请求体。
	Switching Protocols	服务器已同意切换协议。
	Processing	服务器正在处理请求，暂无响应可用。
	Early Hints	在最终响应前预先发送部分响应头。

2xx

Success

10 个

状态码	名称	描述
	OK	请求成功。
	Created	请求成功，新资源已被创建。
	Accepted	请求已被接受，但处理尚未完成。
	Non-Authoritative Information	服务器成功处理了请求，但返回的信息来自第三方来源。
	No Content	服务器成功处理了请求，但未返回任何内容。
	Reset Content	服务器成功处理了请求，要求客户端重置文档视图。
	Partial Content	服务器仅返回了资源的一部分内容（响应范围请求）。
	Multi-Status	响应体包含多个独立操作的响应状态信息（WebDAV）。
	Already Reported	DAV 绑定成员已在之前的多状态响应中枚举过。
	IM Used	服务器已完成请求，响应是对当前实例应用实例操作后的结果。

3xx

Redirection

7 个

状态码	名称	描述
	Multiple Choices	请求的资源有多个可选响应，用户或客户端应选择其一。
	Moved Permanently	请求的资源已永久移动到新位置，未来请求应使用新 URI。
	Found	请求的资源临时移动到其他位置，未来请求仍应使用原 URI。
	See Other	服务器要求客户端用 GET 方法访问另一个 URI 以获取响应。
	Not Modified	资源自上次请求以来未被修改，客户端可使用缓存副本。
	Temporary Redirect	请求应重发到另一个 URI，但方法不变，且未来请求仍应使用原 URI。
	Permanent Redirect	请求及未来所有请求均应发送到指定 URI，且 HTTP 方法不变。

4xx

Client Error

40 个

状态码	名称	描述
	Bad Request	服务器无法处理该请求，通常是客户端语法错误或无效参数。
	Unauthorized	请求需要身份验证，认证失败或未提供凭证。
	Payment Required	保留供将来使用，最初设计用于数字支付系统。
	Forbidden	服务器理解请求但拒绝执行，权限不足。
	Not Found	服务器找不到请求的资源。
	Method Not Allowed	请求方法不被目标资源支持。
	Not Acceptable	服务器无法生成符合客户端 Accept 头要求的响应。
	Proxy Authentication Required	客户端必须先通过代理服务器的身份验证。
	Request Timeout	服务器等待客户端请求超时。
	Conflict	请求与资源当前状态存在冲突，无法处理。
	Gone	请求的资源已永久删除，且不会再次可用。
	Length Required	服务器要求请求包含 Content-Length 头，但未提供。
	Precondition Failed	服务器不满足客户端在请求头中设定的先决条件。
	Content Too Large	请求体超出服务器允许的最大处理大小。
	URI Too Long	请求的 URI 过长，服务器拒绝处理。
	Unsupported Media Type	服务器不支持请求实体的媒体类型（Content-Type）。
	Range Not Satisfiable	客户端请求的文件范围（Range）无效或超出文件大小。
	Expectation Failed	服务器无法满足请求头 Expect 字段中指定的期望条件。
	I'm a Teapot	来自 RFC 2324 的愚人节玩笑：茶壶拒绝煮咖啡。
	Enhance Your Calm	Twitter/X限流响应，非标准状态码，现已被 429 替代。
	Misdirected Request	请求被发送到无法生成合适响应的服务器。
	Unprocessable Content	请求格式正确，但因语义错误无法被处理。
	Locked	请求访问的资源已被锁定（WebDAV）。
	Failed Dependency	请求因依赖的前序请求失败而无法完成（WebDAV）。
	Too Early	服务器不愿处理可能被重放攻击利用的过早请求。
	Upgrade Required	客户端应升级到更高版本的协议（如 TLS）。
	Precondition Required	服务器要求请求附带条件头，以防止并发更新冲突。
	Too Many Requests	客户端在短时间内发送了过多请求，触发限流。
	Request Header Fields Too Large	请求头字段过大，服务器拒绝处理。
	Login Timeout	IIS客户端登录会话已过期，需重新认证。
	No Response	nginx关闭连接且不返回任何响应，常用于屏蔽恶意请求。
	Retry With	IIS服务器要求客户端附带更多信息后重试请求。
	Unavailable For Legal Reasons	因法律原因，服务器拒绝提供对该资源的访问。
	Client Closed Connection	AWS客户端在负载均衡器转发请求前主动关闭了连接。
	Too Many IP Addresses	AWSX-Forwarded-For 请求头中包含超过 30 个 IP 地址。
	Request Header Too Large	nginx请求头超出服务器配置的大小限制。
	SSL Certificate Error	nginx验证客户端 SSL 证书时发生错误。
	SSL Certificate Required	nginx客户端未提供所需的 SSL 证书。
	HTTP Request Sent to HTTPS Port	nginx向 HTTPS 端口发送了明文 HTTP 请求。
	Client Closed Request	nginx客户端在服务器发送响应前主动关闭了连接。

5xx

Server Error

21 个

状态码	名称	描述
	Internal Server Error	服务器遇到意外情况，无法完成请求处理。
	Not Implemented	服务器不支持完成该请求所需的功能。
	Bad Gateway	服务器作为网关或代理时，从上游服务器收到了无效响应。
	Service Unavailable	服务器暂时无法处理请求，通常因过载或停机维护。
	Gateway Timeout	服务器作为网关或代理时，未能及时从上游服务器获得响应。
	HTTP Version Not Supported	服务器不支持请求中使用的 HTTP 协议版本。
	Variant Also Negotiates	服务器内部配置错误，内容协商导致循环引用。
	Insufficient Storage	服务器存储空间不足，无法完成请求（WebDAV）。
	Loop Detected	服务器在处理请求时检测到无限循环（WebDAV）。
	Not Extended	服务器需要请求附加扩展信息才能完成处理。
	Network Authentication Required	客户端需要进行网络身份验证才能获得访问权限（如强制门户）。
	Web Server Returns an Unknown Error	Cloudflare源服务器返回了空响应、未知响应或意外响应。
	Web Server Is Down	Cloudflare源服务器拒绝了连接。
	Connection Timed Out	Cloudflare与源服务器的 TCP 握手超时。
	Origin Is Unreachable	Cloudflare无法访问源服务器，可能是 DNS 解析失败等原因。
	A Timeout Occurred	Cloudflare已建立 TCP 连接，但源服务器未在规定时间内响应。
	SSL Handshake Failed	Cloudflare与源服务器之间的 SSL 握手失败。
	Invalid SSL Certificate	Cloudflare无法验证源服务器的 SSL 证书。
	Railgun Error	Cloudflare与源服务器的 Railgun 连接中断（已废弃功能）。
	Origin DNS Error	Cloudflare无法解析源服务器的 DNS，通常伴随 1xxx 错误码。
	Unauthorized	AWS身份提供商在认证过程中返回了错误代码。