HTTP状态码、接口请求状态码

HTTP状态码是由三位数字组成的数字代码，用于表示HTTP协议处理请求时的返回状态。状态码通常由服务端发送，客户端通过接收状态码来了解请求是否成功，以及出现错误时出错的原因。

以下是HTTP状态码的详细介绍： 

1xx - 信息性状态码

这些状态码表示已接受请求，但仍处于处理过程中。常见的信息性状态码有以下几种：

• 100 Continue（继续）：表示客户端应该继续它的请求
• 101 Switching Protocols（切换协议）：表示客户端需要采用不同协议以完成请求，如升级为WebSocket
• 102 Processing（处理）：表示服务器已经收到并正在处理请求，但客户端仍应继续等待

2xx - 成功状态码

这些状态码表示已成功接收请求并进行了处理。常见的成功状态码有以下几种：

• 200 OK（成功）：表示已成功处理请求，一般用于GET和POST请求
• 201 Created（已创建）：表示已成功创建请求的资源
• 202 Accepted（已接受）：表示已接收请求，但尚未完成处理，需要等待一段时间
• 204 No Content（无内容）：表示成功处理请求，但没有返回任何实体内容

3xx - 重定向状态码

这些状态码表示客户端需要可能的进一步操作才能完成请求，如需要进一步地加载新URL。常见的重定向状态码有以下几种：

• 300 Multiple Choices（多项选择）：表示请求的资源有多个可供选择的表示形式，由客户端进行选择
• 301 Moved Permanently（永久重定向）：表示资源已被永久移除，并且将SE0优化转移到了新的位置
• 302 Found（临时重定向）：表示资源已被临时移动到另一个位置和URL
• 303 See Other（查看其他位置）：表示客户端应当使用另一个URI来访问请求的资源，而不是使用当前URI
• 304 Not Modified（未修改）：表示客户端缓存的资源未发生修改，可以继续使用缓存
• 307 Temporary Redirect（临时重定向）：与302状态码类似，客户端应该继续使用原地址
• 308 Permanent Redirect（永久重定向）：与301状态码类似，客户端应该使用新的URL来访问请求资源

4xx - 客户端错误状态码

这些状态码表示客户端的请求有错误，需修改请求才能成功。常见的客户端错误状态码有以下几种：

• 400 Bad Request（请求出错）：表示请求报文存在语法错误或请求不被服务器所接受
• 401 Unauthorized（未授权）：表示请求未经授权，需进行身份验证
• 403 Forbidden（拒绝访问）：表示服务器拒绝该请求
• 404 Not Found（未找到）：表示请求的资源不存在
• 405 Method Not Allowed（方法不被允许）：表示请求中所指定的方法不被服务器支持
• 406 Not Acceptable（不可接受）：表示客户端请求的内容格式服务器不支持
• 407 Proxy Authentication Required（需要代理身份验证）：表示客户端需要先使用代理服务器进行身份验证才能访问所需资源
• 408 Request Timeout（请求超时）：表示请求超时，服务器等待的时间过长
• 409 Conflict（请求冲突）：表示请求冲突，且仅适用于PUT请求
• 410 Gone（已被删除）：表示请求的资源已被永久删除
• 411 Length Required（需要长度）：表示服务端必须提供 Content-Length 头信息
• 412 Precondition Failed（前置条件不满足）：表示客户端请求的条件无法服务端满足
• 413 Payload Too Large（请求体太大）：表示服务器拒绝处理请求，请求过于庞大
• 414 URI Too Long（URI太长）：表示请求中的URI过长，服务器无法处理
• 415 Unsupported Media Type（不支持的媒体类型）：表示客户端请求的内容格式不被服务器支持
• 416 Range Not Satisfiable（范围无效）：表示服务器无法提供请求的范围，如请求的资源不存在
• 417 Expectation Failed（服务器无法处理Expect头字段指定的期望值）：表示服务器无法满足客户端在Expect头字段中指定的扩展请求信息
• 421 Misdirected Request（该对端服务器错）：表示服务器要求客户端通过另一个协议或IP地址访问资源，以便更好的控制负载平衡。
• 422 Unprocessable Entity（请求格式正确，但语义有误）：表示请求格式正确，但是由于含有语义错误，无法被服务器识别
• 423 Locked（当前请求的资源被锁定）：表示由于资源被锁定，请求无法处理
• 424 Failed Dependency（请求失败依赖）：表示一个先前的请求失败，导致此次请求失败
• 425 Too Early（请求过早）：表示请求过早，任何操作都不能执行
• 426 Upgrade Required（需要升级协议）：表示客户端需要切换协议以完成请求
• 428 Precondition Required（此时请求需满足先决条件）：表示缺少先决条件，请求无法被处理
• 429 Too Many Requests（请求过多）：表示请求次数超出了服务器的限制
• 431 Request Header Fields Too Large（请求头超大）：表示请求头部字段或cookie长度过大，服务器无法处理
• 451 Unavailable For Legal Reasons（由于法律原因无法获得）：表示服务器由于法律原因无法处理请求

5xx - 服务器端错误状态码

这些状态码表示服务器在处理请求时遇到错误或无法完成请求。常见的服务器端错误状态码有以下几种：

• 500 Internal Server Error（内部服务器错误）：表示服务器在处理请求时遇到错误
• 501 Not Implemented（未实现）：表示服务器不支持请求的功能
• 502 Bad Gateway（错误网关）：表示网关或代理服务器收到无效响应
• 503 Service Unavailable（服务不可用）：表示服务器暂时无法处理请求，如服务器过载、停机等
• 504 Gateway Timeout（网关超时）：表示网关或代理服务器在规定时间内未能接收到响应
• 505 HTTP Version Not Supported（HTTP协议版本不被支持）：表示服务器不支持请求中所用的HTTP协议版本
• 506 Variant Also Negotiates（协商变量也行）：表示服务器在内部配置错误
• 507 Insufficient Storage（存储空间溢出）：表示服务器无法存储完成请求所必须的内容
• 508 Loop Detected（检测到循环）：表示服务器在处理请求时检测到循环
• 510 Not Extended（不可扩展）：表示客户端需要进行额外的扩展以完成请求
• 511 Network Authentication Required（需要网络认证）：表示客户端需要进行网络认证以完成请求

获取状态码示例

在Java中，使用HttpURLConnection或OkHttp等库发送Http请求，可以通过getResponseCode()方法来获取状态码。下面是一个示例代码：

URL url = new URL("http://www.example.com");
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
connection.setRequestMethod("GET");
int statusCode = connection.getResponseCode();

以上代码是使用HttpURLConnection发送Get请求，并获取响应的状态码。

小结

以上就是HTTP协议中定义的所有状态码及其含义。了解这些状态码，可以更好地判断请求返回结果是否符合预期，有助于开发人员进行debug和问题排查。当HTTP协议定义的状态码不足以表达具体的问题时，HTTP会在响应消息体中进一步描述具体问题信息。无论是服务器端还是客户端，都可以通过状态码及其描述信息来判断问题所在，以便及时得到解决。