2. HTTP 状态码

2. HTTP 状态码

状态码的类别:

2XX (Success 成功状态码)

状态码 2XX 表示请求被正常处理了。

200 OK

200 OK 表示客户端发来的请求被服务器端正常处理了。

204 No Content

该状态码表示客户端发送的请求已经在服务器端正常处理了, 但是没有返回的内容, 响应报文中不包含实体的主体部分。一般在只需要从客户端往服务器端发送信息, 而服务器端不需要往客户端发送内容时使用。

206 Partial Content

该状态码表示客户端进行了范围请求, 而服务器端执行了这部分的 GET 请求。响应报文中包含由 Content-Range 指定范围的实体内容。

3XX (Redirection 重定向状态码)

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

301 Moved Permanently

永久重定向。该状态码表示请求的资源已经被分配了新的 URI, 以后应使用资源指定的 URI。新的 URI 会在 HTTP 响应头中的 Location首部字段指定。若用户已经把原来的 URI
保存为书签, 此时会按照 Location 中新的URI重新保存该书签。同时, 搜索引擎在抓取新内容的同时也将旧的网址替换为重定向之后的网址。

使用场景:

当我们想换个域名, 旧的域名不再使用时, 用户访问旧域名时用 301 就重定向到新的域名。其实也是告诉搜索引擎收录的域名需要对新的域名进行收录。
在搜索引擎的搜索结果中出现了不带 www 的域名, 而带 www 的域名却没有收录, 这个时候可以用 301 重定向来告诉搜索引擎我们目标的域名是哪一个。

302 Found

临时重定向。该状态码表示请求的资源被分配到了新的 URI, 希望用户(本次)能使用新的 URI 访问资源。和 301 Moved Permanently 状态码相似, 但是
302 代表的资源不是被永久重定向, 只是临时性质的。也就是说已移动的资源对应的 URI 将来还有可能发生改变。若用户把 URI
保存成书签, 但不会像 301 状态码出现时那样去更新书签, 而是仍旧保留返回 302 状态码的页面对应的
URI。同时, 搜索引擎会抓取新的内容而保留旧的网址。因为服务器返回 302 代码, 搜索引擎认为新的网址只是暂时的。

使用场景:

• 当我们在做活动时, 登录到首页自动重定向, 进入活动页面
• 未登陆的用户访问用户中心重定向到登录页面
• 访问 404 页面重新定向到首页

303 See Other

该状态码表示由于请求对应的资源存在着另一个 URI, 应使用 GET 方法定向获取请求的资源。
303 状态码和 302 Found 状态码有着相似的功能, 但是 303 状态码明确表示客户端应当采用 GET 方法获取资源。
303 状态码通常作为 PUT 或 POST 操作的返回结果, 它表示重定向链接指向的不是新上传的资源, 而是另外一个页面, 比如消息确认页面或上传进度页面。而请求重定向页面的方法要总是使用 GET。

注意:

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

304 Not Modified

浏览器缓存相关。该状态码表示客户端发送附带条件的请求时, 服务器端允许请求访问资源, 但未满足条件的情况。304 状态码返回时, 不包含任何响应的主体部分。304
虽然被划分在 3XX 类别中, 但是和重定向没有关系。

带条件的请求(Http 条件请求): 使用 Get 方法请求, 请求报文中包含(if-match、if-none-match、if-modified-since、if-unmodified-since、if-range)中任意首部。

状态码 304 并不是一种错误, 而是告诉客户端有缓存, 直接使用缓存中的数据。返回页面的只有头部信息, 是没有内容部分的, 这样在一定程度上提高了网页的性能。

307 Temporary Redirect

307 表示临时重定向。该状态码与 302 Found 有着相同含义, 尽管 302 标准禁止 POST 变成 GET, 但是实际使用时还是这样做了。
307 会遵守浏览器标准, 不会从 POST 变成 GET。但是对于处理请求的行为时, 不同浏览器还是会出现不同的情况。规范要求浏览器继续向 Location 的地址 POST 内容。规范要求浏览器继续向
Location 的地址 POST 内容。

4XX (Client Error 客户端错误状态码)

4XX 的响应结果表明客户端是发生错误的原因所在。

400 Bad Request

该状态码表示请求报文中存在语法错误。当错误发生时, 需修改请求的内容后再次发送请求。另外, 浏览器会像 200 OK 一样对待该状态码。

401 Unauthorized

该状态码表示发送的请求需要有通过 HTTP 认证(BASIC 认证、DIGEST 认证)的认证信息。若之前已进行过一次请求, 则表示用户认证失败
返回含有 401 的响应必须包含一个适用于被请求资源的 WWW-Authenticate 首部用以质询(challenge)用户信息。当浏览器初次接收到
401 响应, 会弹出认证用的对话窗口。

以下情况会出现 401:

• 401.1 - 登录失败
• 401.2 - 服务器配置导致登录失败
• 401.3 - 由于 ACL 对资源的限制而未获得授权
• 401.4 - 筛选器授权失败
• 401.5 - ISAPI/CGI 应用程序授权失败
• 401.7 - 访问被 Web 服务器上的 URL 授权策略拒绝。这个错误代码为 IIS 6.0 所专用

403 Forbidden

该状态码表明请求资源的访问被服务器拒绝了, 服务器端没有必要给出详细理由, 但是可以在响应报文实体的主体中进行说明。进入该状态后, 不能再继续进行验证。该访问是永久禁止的, 并且与应用逻辑密切相关。

IIS 定义了许多不同的 403 错误, 它们指明更为具体的错误原因:

• 403.1 - 执行访问被禁止
• 403.2 - 读访问被禁止
• 403.3 - 写访问被禁止
• 403.4 - 要求 SSL
• 403.5 - 要求 SSL 128
• 403.6 - IP 地址被拒绝
• 403.7 - 要求客户端证书
• 403.8 - 站点访问被拒绝
• 403.9 - 用户数过多
• 403.10 - 配置无效
• 403.11 - 密码更改
• 403.12 - 拒绝访问映射表
• 403.13 - 客户端证书被吊销
• 403.14 - 拒绝目录列表
• 403.15 - 超出客户端访问许可
• 403.16 - 客户端证书不受信任或无效
• 403.17 - 客户端证书已过期或尚未生效
• 403.18 - 在当前的应用程序池中不能执行所请求的 URL。这个错误代码为 IIS 6.0 所专用
• 403.19 - 不能为这个应用程序池中的客户端执行 CGI。这个错误代码为 IIS 6.0 所专用
• 403.20 - Passport 登录失败。这个错误代码为 IIS 6.0 所专用

404 Not Found

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

以下情况会出现 404:

• 404.0 - (无) – 没有找到文件或目录
• 404.1 - 无法在所请求的端口上访问 Web 站点
• 404.2 - Web 服务扩展锁定策略阻止本请求
• 404.3 - MIME 映射策略阻止本请求

405 Method Not Allowed

该状态码表示客户端请求的方法虽然能被服务器识别, 但是服务器禁止使用该方法。GET 和 HEAD 方法, 服务器应该总是允许客户端进行访问。客户端可以通过
OPTIONS 方法(预检)来查看服务器允许的访问方法, 如下:

Access-Control-Allow-Methods: GET,HEAD,PUT,PATCH,POST,DELETE
1

5XX (Server Error 服务器错误状态码)

5XX 的响应结果表明服务器本身发生错误。

500 Internal Server Error

该状态码表明服务器端在执行请求时发生了错误。也有可能是 Web 应用存在的 bug 或某些临时的故障。

502 Bad Gateway

该状态码表明扮演网关或代理角色的服务器, 从上游服务器中接收到的响应是无效的。注意, 502 错误通常不是客户端能够修复的, 而是需要由途经的
Web 服务器或者代理服务器对其进行修复。

以下情况会出现 502:

• 502.1 - CGI (通用网关接口)应用程序超时
• 502.2 - CGI (通用网关接口)应用程序出错

503 Service Unavailable

该状态码表明服务器暂时处于超负载或正在进行停机维护, 现在无法处理请求。如果事先得知解除以上状况需要的时间, 最好写入
RetryAfter 首部字段再返回给客户端。

使用场景:

• 服务器停机维护时, 主动用 503 响应请求
• nginx 设置限速, 超过限速, 会返回 503

504 Gateway Timeout

该状态码表示网关或者代理的服务器无法在规定的时间内获得想要的响应。他是 HTTP 1.1 中新加入的。

使用场景: 代码执行时间超时, 或者发生了死循环。

总结

2XX 成功

• 200 OK, 表示从客户端发来的请求在服务器端被正确处理
• 204 No content, 表示请求成功, 但响应报文不含实体的主体部分
• 205 Reset Content, 表示请求成功, 但响应报文不含实体的主体部分, 但是与 204 响应不同在于要求请求方重置内容
• 206 Partial Content, 进行范围请求

3XX 重定向

• 301 moved permanently, 永久性重定向, 表示资源已被分配了新的 URL
• 302 found, 临时性重定向, 表示资源临时被分配了新的 URL
• 303 see other, 表示资源存在着另一个 URL, 应使用 GET 方法获取资源
• 304 not modified, 表示服务器允许访问资源, 但因发生请求未满足条件的情况
• 307 temporary redirect, 临时重定向, 和 302 含义类似, 但是期望客户端保持请求方法不变向新的地址发出请求

4XX 客户端错误

• 400 bad request, 请求报文存在语法错误
• 401 unauthorized, 表示发送的请求需要有通过 HTTP 认证的认证信息
• 403 forbidden, 表示对请求资源的访问被服务器拒绝
• 404 not found, 表示在服务器上没有找到请求的资源

5XX 服务器错误

• 500 internal sever error, 表示服务器端在执行请求时发生了错误
• 501 Not Implemented, 表示服务器不支持当前请求所需要的某个功能
• 503 service unavailable, 表明服务器暂时处于超负载或正在停机维护, 无法处理请求