HTTP 状态码大全

红太狼 2022-04-05 08:55 217阅读 0赞

# HTTP 状态码大全 #

HTTPError 是 URLError 的子类，服务器上每一个 HTTP 的响应都包含一个数字的“状态码”。  
  
有时候状态码会指出服务器无法完成的请求类型，一般情况下 Python 会帮你处理一部分这类响应（例如，响应的是一个“重定向”，要求客户端从别的地址来获取文档，那么 urllib 会自动为你处理这个响应。）；但是呢，有一些无法处理的，就会抛出 HTTPError 异常。这些异常包括典型的：404（页面无法找到），403（请求禁止）和 401（验证请求）。  
  
因为 Python 默认会自动帮你处理[重定向][Link 1]方面的内容（状态码 300 ~ 399 范围），状态码 100 ~ 299 的范围是表示成功，所以你**需要关注的是 400 ~ 599 这个范围的状态码（因为它们代表响应出了问题）。**  
  
其中，**出现 4xx 的状态码，说明问题来自客户端，**就是你自己哪里做错了；**出现 5xx 的状态码，那就表示与你无关了，是来自服务器的问题。**

`http.server.BaseHTTPRequestHandler.responses`这个字典为显示了所有 RFC 2616 会用到的状态码，为了方便大家学习，我将其进行的翻译并整理：

下表列举了常用的 HTTP 状态码以及详细的含义：

<table> 
 <tbody> 
 <tr> 
 <td style="width:70px;"> 状态码 </td> 
 <td style="width:188px;">&nbsp;&nbsp;内容</td> 
 <td style="width:590px;">&nbsp;详细内容</td> 
 </tr> 
 <tr> 
 <td colspan="3">&nbsp; &nbsp;&nbsp; &nbsp;&nbsp; &nbsp;&nbsp; &nbsp;&nbsp; &nbsp;&nbsp; &nbsp;&nbsp; &nbsp;&nbsp; &nbsp;</td> 
 </tr> 
 <tr> 
 <td style="width:70px;"> 1xx </td> 
 <td colspan="2">这一类型的状态码，代表请求已被接受，需要继续处理。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;"> 100 </td> 
 <td style="width:188px;">&nbsp;&nbsp; Continue &nbsp;&nbsp;</td> 
 <td style="width:590px;">收到请求，客户端应当继续发送请求。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;101</td> 
 <td style="width:188px;">&nbsp;&nbsp; Switching&nbsp;&nbsp;Protocols &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器通过 Upgrade 消息头通知客户端采用不同的协议来完成这个请求。</td> 
 </tr> 
 <tr> 
 <td colspan="3">&nbsp;</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 2xx &nbsp;&nbsp;</td> 
 <td colspan="2">成功 | 这一类型的状态码，代表请求已成功被服务器接收、理解、并接受。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 200 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; OK &nbsp;&nbsp;</td> 
 <td style="width:590px;">请求已成功，请求的响应头或数据体将随此响应返回。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 201 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Created &nbsp;&nbsp;</td> 
 <td style="width:590px;">请求已经被实现，而且有一个新的资源已经依据请求的需要而创建，且其 URI 已经随 Location&nbsp;&nbsp;头信息返回。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 202 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Accepted &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器已接受请求，但尚未处理。正如它可能被拒绝一样，最终该请求可能会也可能不会被执行。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 203 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Non-Authoritative&nbsp;&nbsp;Information &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器已成功处理了请求，但返回的实体头部元信息不是在原始服务器上有效的确定集合，而是来自本地或者第三方的拷贝。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 204 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; No&nbsp;&nbsp;Content &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器成功处理了请求，但没有返回任何实体内容。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 205 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Reset&nbsp;&nbsp;Content &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器成功处理了请求，且没有返回任何内容。但是与204响应不同，返回此状态码的响应要求请求者重置文档视图。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 206 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Partial&nbsp;&nbsp;Content &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器已经成功处理了部分 GET 请求。</td> 
 </tr> 
 <tr> 
 <td colspan="3">&nbsp;</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 3xx &nbsp;&nbsp;</td> 
 <td colspan="2">重定向 | 这类状态码代表需要客户端采取进一步的操作才能完成请求。通常，这些状态码用来重定向，后续的请求地址（重定向目标）在本次响应的 Location 域中指明。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 300 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Multiple&nbsp;&nbsp;Choices &nbsp;&nbsp;</td> 
 <td style="width:590px;">被请求的资源有一系列可供选择的回馈信息，每个都有自己特定的地址和浏览器驱动的商议信息。用户或浏览器能够自行选择一个首选的地址进行重定向。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 301 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Moved&nbsp;&nbsp;Permanently &nbsp;&nbsp;</td> 
 <td style="width:590px;">被请求的资源已永久移动到新位置，并且将来任何对此资源的引用都应该使用本响应返回的若干个 URI 之一。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 302 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Found &nbsp;&nbsp;</td> 
 <td style="width:590px;">请求的资源现在临时从不同的 URI 响应请求。由于这样的重定向是临时的，客户端应当继续向原有地址发送以后的请求。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 303 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; See&nbsp;&nbsp;Other &nbsp;&nbsp;</td> 
 <td style="width:590px;">对应当前请求的响应可以在另一个 URI 上被找到，而且客户端应当采用 GET 的方式访问那个资源。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 304 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Not&nbsp;&nbsp;Modified &nbsp;&nbsp;</td> 
 <td style="width:590px;">如果客户端发送了一个带条件的 GET 请求且该请求已被允许，而文档的内容（自上次访问以来或者根据请求的条件）并没有改变，则服务器应当返回这个状态码。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 305 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Use&nbsp;&nbsp;Proxy &nbsp;&nbsp;</td> 
 <td style="width:590px;">被请求的资源必须通过指定的代理才能被访问。Location&nbsp;&nbsp;域中将给出指定的代理所在的URI信息，接收者需要重复发送一个单独的请求，通过这个代理才能访问相应资源。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 307 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Temporary&nbsp;&nbsp;Redirect &nbsp;&nbsp;</td> 
 <td style="width:590px;">请求的资源现在临时从不同的 URI 响应请求。由于这样的重定向是临时的，客户端应当继续向原有地址发送以后的请求。</td> 
 </tr> 
 <tr> 
 <td colspan="3">&nbsp;</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 4xx &nbsp;&nbsp;</td> 
 <td colspan="2">客户端错误 | 这类的状态码代表了客户端看起来可能发生了错误，妨碍了服务器的处理。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 400 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Bad&nbsp;&nbsp;Request &nbsp;&nbsp;</td> 
 <td style="width:590px;">由于包含语法错误，当前请求无法被服务器理解。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 401 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Unauthorized &nbsp;&nbsp;</td> 
 <td style="width:590px;">当前请求需要用户验证。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 402 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Payment&nbsp;&nbsp;Required &nbsp;&nbsp;</td> 
 <td style="width:590px;">该状态码是为了将来可能的需求而预留的。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 403 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Forbidden &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器已经理解请求，但是拒绝执行它。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 404 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Not&nbsp;&nbsp;Found &nbsp;&nbsp;</td> 
 <td style="width:590px;">请求失败，请求的资源在服务器上找不到。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 405 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Method&nbsp;&nbsp;Not Allowed &nbsp;&nbsp;</td> 
 <td style="width:590px;">请求中指定的请求方法不能被用于请求相应的资源。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 406 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Not&nbsp;&nbsp;Acceptable &nbsp;&nbsp;</td> 
 <td style="width:590px;">请求的资源的内容特性无法满足请求头中的条件，因而无法生成响应实体。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 407 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Proxy&nbsp;&nbsp;Authentication Required &nbsp;&nbsp;</td> 
 <td style="width:590px;">与 401 状态码类似，只不过客户端必须在代理服务器上进行身份验证。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 408 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Request&nbsp;&nbsp;Timeout &nbsp;&nbsp;</td> 
 <td style="width:590px;">请求超时。客户端没有在服务器预备等待的时间内完成一个请求的发送。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 409 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Conflict &nbsp;&nbsp;</td> 
 <td style="width:590px;">由于和被请求的资源的当前状态之间存在冲突，请求无法完成。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 410 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Gone &nbsp;&nbsp;</td> 
 <td style="width:590px;">被请求的资源在服务器上已经不再可用，而且没有任何已知的转发地址。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 411 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Length&nbsp;&nbsp;Required &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器拒绝在没有定义&nbsp;&nbsp;Content-Length 头的情况下接受请求。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 412 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Precondition&nbsp;&nbsp;Failed &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器在验证在请求的头字段中给出先决条件时，没能满足其中的一个或多个。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 413 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Request&nbsp;&nbsp;Entity Too Large &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器拒绝处理当前请求，因为该请求提交的实体数据大小超过了服务器愿意或者能够处理的范围。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 414 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Request-URI&nbsp;&nbsp;Too Long &nbsp;&nbsp;</td> 
 <td style="width:590px;">请求的 URI 长度超过了服务器能够解释的长度，因此服务器拒绝对该请求提供服务。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 415 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Unsupported&nbsp;&nbsp;Media Type &nbsp;&nbsp;</td> 
 <td style="width:590px;">对于当前请求的方法和所请求的资源，请求中提交的实体并不是服务器中所支持的格式，因此请求被拒绝。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 416 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Requested&nbsp;&nbsp;Range Not Satisfiable &nbsp;&nbsp;</td> 
 <td style="width:590px;">如果请求中包含了 Range 请求头，并且 Range 中指定的任何数据范围都与当前资源的可用范围不重合，同时请求中又没有定义 If-Range 请求头，那么服务器就应当返回 416 状态码。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 417 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Expectation&nbsp;&nbsp;Failed &nbsp;&nbsp;</td> 
 <td style="width:590px;">在请求头 Expect 中指定的预期内容无法被服务器满足，或者这个服务器是一个代理服务器，它有明显的证据证明在当前路由的下一个节点上，Expect 的内容无法被满足。</td> 
 </tr> 
 <tr> 
 <td colspan="3">&nbsp;</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 5xx &nbsp;&nbsp;</td> 
 <td colspan="2">服务器错误 | 这类状态码代表了服务器在处理请求的过程中有错误或者异常状态发生。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 500 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Internal&nbsp;&nbsp;Server Error &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器遇到了一个未曾预料的状况，导致了它无法完成对请求的处理。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 501 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Not&nbsp;&nbsp;Implemented &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器不支持当前请求所需要的某个功能。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 502 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Bad&nbsp;&nbsp;Gateway &nbsp;&nbsp;</td> 
 <td style="width:590px;">作为网关或者代理工作的服务器尝试执行请求时，从上游服务器接收到无效的响应。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 503 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Service&nbsp;&nbsp;Unavailable &nbsp;&nbsp;</td> 
 <td style="width:590px;">由于临时的服务器维护或者过载，服务器当前无法处理请求。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 504 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; Gateway&nbsp;&nbsp;Timeout &nbsp;&nbsp;</td> 
 <td style="width:590px;">作为网关或者代理工作的服务器尝试执行请求时，未能及时从上游服务器（URI 标识出的服务器，例如 HTTP、FTP、LDAP）或者辅助服务器（例如 DNS）收到响应。</td> 
 </tr> 
 <tr> 
 <td style="width:70px;">&nbsp;&nbsp; 505 &nbsp;&nbsp;</td> 
 <td style="width:188px;">&nbsp;&nbsp; HTTP&nbsp;&nbsp;Version Not Supported &nbsp;&nbsp;</td> 
 <td style="width:590px;">服务器不支持，或者拒绝支持在请求中使用的HTTP版本。</td> 
 </tr> 
 </tbody> 
</table>

下面是文档的原文：

>     # Table mapping response codes to messages; entries have the
>     # form {code: (shortmessage, longmessage)}.
>     responses = {
>         100: ('Continue', 'Request received, please continue'),
>         101: ('Switching Protocols',
>               'Switching to new protocol; obey Upgrade header'),
>     
>         200: ('OK', 'Request fulfilled, document follows'),
>         201: ('Created', 'Document created, URL follows'),
>         202: ('Accepted',
>               'Request accepted, processing continues off-line'),
>         203: ('Non-Authoritative Information', 'Request fulfilled from cache'),
>         204: ('No Content', 'Request fulfilled, nothing follows'),
>         205: ('Reset Content', 'Clear input form for further input.'),
>         206: ('Partial Content', 'Partial content follows.'),
>     
>         300: ('Multiple Choices',
>               'Object has several resources -- see URI list'),
>         301: ('Moved Permanently', 'Object moved permanently -- see URI list'),
>         302: ('Found', 'Object moved temporarily -- see URI list'),
>         303: ('See Other', 'Object moved -- see Method and URL list'),
>         304: ('Not Modified',
>               'Document has not changed since given time'),
>         305: ('Use Proxy',
>               'You must use proxy specified in Location to access this '
>               'resource.'),
>         307: ('Temporary Redirect',
>               'Object moved temporarily -- see URI list'),
>     
>         400: ('Bad Request',
>               'Bad request syntax or unsupported method'),
>         401: ('Unauthorized',
>               'No permission -- see authorization schemes'),
>         402: ('Payment Required',
>               'No payment -- see charging schemes'),
>         403: ('Forbidden',
>               'Request forbidden -- authorization will not help'),
>         404: ('Not Found', 'Nothing matches the given URI'),
>         405: ('Method Not Allowed',
>               'Specified method is invalid for this server.'),
>         406: ('Not Acceptable', 'URI not available in preferred format.'),
>         407: ('Proxy Authentication Required', 'You must authenticate with '
>               'this proxy before proceeding.'),
>         408: ('Request Timeout', 'Request timed out; try again later.'),
>         409: ('Conflict', 'Request conflict.'),
>         410: ('Gone',
>               'URI no longer exists and has been permanently removed.'),
>         411: ('Length Required', 'Client must specify Content-Length.'),
>         412: ('Precondition Failed', 'Precondition in headers is false.'),
>         413: ('Request Entity Too Large', 'Entity is too large.'),
>         414: ('Request-URI Too Long', 'URI is too long.'),
>         415: ('Unsupported Media Type', 'Entity body in unsupported format.'),
>         416: ('Requested Range Not Satisfiable',
>               'Cannot satisfy request range.'),
>         417: ('Expectation Failed',
>               'Expect condition could not be satisfied.'),
>     
>         500: ('Internal Server Error', 'Server got itself in trouble'),
>         501: ('Not Implemented',
>               'Server does not support this operation'),
>         502: ('Bad Gateway', 'Invalid responses from another server/proxy.'),
>         503: ('Service Unavailable',
>               'The server cannot process the request due to a high load'),
>         504: ('Gateway Timeout',
>               'The gateway server did not receive a timely response'),
>         505: ('HTTP Version Not Supported', 'Cannot fulfill request.'),
>         }

[Link 1]: https://baike.baidu.com/item/%E9%87%8D%E5%AE%9A%E5%90%91/9064196?fr=aladdin