Skip to content

返回结果的 HTTP 状态码

以 3 位数字和原因短语组成。

数字中的第一位指定了响应类别,后两位无分类。

下面介绍代表性的14种状态码。

1. 2XX 成功⚓

1.1 200 OK⚓

在响应报文内,随状态码一起返回的信息会因方法的不同而发生改变。

1.2 204 No Content⚓

该状态码代表服务器接收的请求已成功处理,但在返回的响应报文中不含实体的主体部分。

1.3 206 Partial Content⚓

响应报文中包含由 Content-Range 指定范围的实体内容。

2. 3XX 重定向⚓

3XX 响应结果表明浏览器需要执行某些特殊的处理以正确处理请求。

2.1 301 Moved Permanently⚓

永久性重定向。该状态码表示请求的资源已被分配了新的 URI,以后应使用资源现在所指的 URI。

2.2 302 Found⚓

临时性重定向。该状态码表示请求的资源已被分配了新的 URI,希望用户(本次)能使用新的 URI 访问。

302 状态码代表的资源不是被永久移动,只是临时性质的。换句话说,已移动的资源对应的 URI 将来还有可能发生改变。

2.3 303 See Other⚓

该状态码表示由于请求对应的资源存在着另一个 URI,应使用 GET 方法定向获取请求的资源。

303 状态码和 302 Found 状态码有着相同的功能,但 303 状态码明确表示客户端应当采用 GET 方法获取资源。

注意:当 301、302、303 响应状态码返回时,几乎所有的浏览器都会把POST 改成 GET,并删除请求报文内的主体,之后请求会自动再次发送。 301、302 标准是禁止将 POST 方法改变成 GET 方法的,但实际使用时大家都会这么做。

2.4 304 Not Modified⚓

该状态码表示客户端发送附带条件的请求(附带条件的请求是指采用 GET 方法的请求报文中包含 If-Match,If-ModifiedSince,If-None-Match,If-Range,If-Unmodified-Since 中任一首部)时,服务器端允许请求访问资源,但未满足条件的情况。304 状态码返回时,不包含任何响应的主体部分。

2.5 307 Temporary Redirect⚓

临时重定向。该状态码与 302 Found 有着相同的含义。

区别就是 307 会遵照浏览器标准,不会从 POST 变成 GET。但是,对于处理响应时的行为,每种浏览器有可能出现不同的情况。

3. 4XX 客户端错误⚓

3.1 400 Bad Request⚓

该状态码表示请求报文中存在语法错误。另外,浏览器会像 200 OK 一样对待该状态码。

3.2 401 Unauthorized⚓

该状态码表示发送的请求需要有通过 HTTP 认证(BASIC 认证、DIGEST 认证)的认证信息。当浏览器初次接收到 401 响应,会弹出认证用的对话窗口;再次接收到请求并返回该状态码时,则表示认证失败。

3.3 403 Forbidden⚓

对请求资源的访问被服务器拒绝了。可以在实体的主体部分对原因作描述。

3.4 404 Not Found⚓

服务器上无法找到请求的资源。除此之外,也可以在服务器端拒绝请求且不想说明理由时使用。

4. 5XX 服务器错误⚓

4.1 500 Internal Server Error⚓

表明服务器端在执行请求时发生了错误。

4.2 503 Service Unavailable⚓

表明服务器暂时处于超负载或正在进行停机维护,现在无法处理请求。