# 2XX

2×× 类状态码表示服务器收到并成功处理了客户端的请求,这也是客户端最愿意看到的状态码

# 200 OK

是最常见的成功状态码,表示一切正常,服务器如客户端所期望的那样返回了处理结果

# 204 No Content”

它的含义与“200 OK”基本相同,但响应头后没有 body 数据

# 206 Partial Content

是 HTTP 分块下载或断点续传的基础,在客户端发送“范围请求”、要求获取资源的 部分数据时出现,它与 200 一样,也是服务器成功处理了请求,但 body 里的数据不是资源的全部,而是其中 的一部分。

TIP

状态码 206 通常还会伴随着头字段“Content-Range”,表示响应报文里 body 数据的具体范围,供客户端确 认,例如“Content-Range: bytes 0-99/2000”,意思是此次获取的是总计 2000 个字节的前 100 个字节

# 3××

3×× 类状态码表示客户端请求的资源发生了变动,客户端必须用新的 URI 重新发送请求获取资源,也就是通 常所说的“重定向”,包括著名的 301、302 跳转。

# 301 Moved Permanently

俗称“永久重定向”,含义是此次请求的资源已经不存在了,需要改用改用新 的 URI 再次访问。

# 302 Found

临时重定向”,意思是 请求的资源还在,但需要暂时用另一个 URI 来访问

TIP

301 和 302 都会在响应头里使用字段 Location 指明后续要跳转的 URI,最终的效果很相似,浏览器都会重定向 到新的 URI。两者的根本区别在于语义,一个是“永久”,一个是“临时”,所以在场景、用法上差距很 大

# 304 Not Modified

它用于 If-Modified-Since 等条件请求,表示资源未修 改,用于缓存控制。它不具有通常的跳转含义,但可以理解成“重定向已到缓存的文件”(即“缓存重定 向”)

# 4××

4×× 类状态码表示客户端发送的请求报文有误,服务器无法处理,它就是真正的“错误码”含义了

# 400 Bad Request

表示请求报文有错误,但具体是数据格式错误、缺少请求头还 是 URI 超长它没有明确说,只是一个笼统的错误

# 403 Forbidden

表示服务器禁止访问资源

# 404 Not Found

原意是资源在本服务器上未 找到,所以无法提供给客户端。

4×× 里剩下的一些代码较明确地说明了错误的原因,都很好理解,开发中常用的有:

  • 405 Method Not Allowed:不允许使用某些方法操作资源,例如不允许 POST 只能 GET;
  • 406 Not Acceptable:资源无法满足客户端请求的条件,例如请求中文但只有英文;
  • 408 Request Timeout:请求超时,服务器等待了过长的时间;
  • 409 Conflict:多个请求发生了冲突,可以理解为多线程并发时的竞态;
  • 413 Request Entity Too Large:请求报文里的 body 太大;
  • 414 Request-URI Too Long:请求行里的 URI 太大;
  • 429 Too Many Requests:客户端发送了太多的请求,通常是由于服务器的限连策略; 431 Request Header Fields Too Large:请求头某个字段或总体太大;

# 5××

5×× 类状态码表示客户端请求报文正确,但服务器在处理时内部发生了错误,无法返回应有的响应数据,是 服务器端的“错误码”

# 500 Internal Server Error

服务器内部错误

# 501 Not Implemented

表示客户端请求的功能还不支持

# 502 Bad Gateway

通常是服务器作为网关或者代理时返回的错误码,表示服务器自身工作正常,访问后端服务器时发生了错误

# 503 Service Unavailable

表示服务器当前很忙,暂时无法响应服务

TIP

503 是一个“临时”的状态,很可能过几秒钟后服务器就不那么忙了,可以继续提供服务,所以 503 响应报 文里通常还会有一个“Retry-After”字段,指示客户端可以在多久以后再次尝试发送请求