网络状态码-经验笔记

网络状态码-经验笔记

引言

在网络通信中，HTTP（Hypertext Transfer Protocol）状态码是服务器向客户端（通常是Web浏览器）发送响应时所包含的重要信息之一。
这些状态码指示了客户端请求的结果。
了解并正确使用这些状态码对于构建健壮的Web应用和服务至关重要。

HTTP状态码分类

HTTP状态码分为五大类，每种类别代表了不同含义：

1. 1xx Informational（信息性状态码）
2. 2xx Successful（成功状态码）
3. 3xx Redirection（重定向状态码）
4. 4xx Client Error（客户端错误状态码）
5. 5xx Server Error（服务器错误状态码）

1xx Informational

这类状态码用于传输过程中的临时响应，客户端应继续处理请求或等待进一步的信息。

• 100 Continue：指示客户端继续发送请求的剩余部分。
• 101 Switching Protocols：服务器正在切换协议，遵照Upgrade请求头字段的值。

2xx Successful

这类状态码表示请求已被成功接收、理解和接受。

• 200 OK：标准的响应成功状态码。
• 201 Created：请求成功且创建了一个新的资源。
• 202 Accepted：请求已接受待处理，但处理尚未完成。
• 204 No Content：请求已成功处理，但没有返回任何内容。
• 206 Partial Content：服务器已成功处理了部分GET请求。

3xx Redirection

这类状态码指示需要客户端采取进一步的动作才能完成请求。

• 300 Multiple Choices：请求的资源对应多个位置，客户端可以选择其中一个。
• 301 Moved Permanently：请求的资源已永久移动到新位置。
• 302 Found (Temporary Redirect)：请求的资源临时位于不同的URI，未来请求应使用原来的URI。
• 303 See Other：客户端应通过GET方法重定向到另一个URI。
• 304 Not Modified：客户端已拥有资源的最新版本，无需再次下载。
• 307 Temporary Redirect：请求的资源临时位于不同的URI，但未来请求应使用原来的URI。
• 308 Permanent Redirect：请求的资源已永久移动到新位置，客户端应使用新的URI。

4xx Client Error

这类状态码表示客户端发送的请求有错误，服务器无法处理。

• 400 Bad Request：服务器无法理解请求的格式。
• 401 Unauthorized：请求需要用户身份验证。
• 403 Forbidden：服务器理解请求客户端的请求，但拒绝执行此请求。
• 404 Not Found：请求的资源不存在。
• 405 Method Not Allowed：请求的方法（如POST、GET等）不被允许用于请求的资源。
• 409 Conflict：请求与当前资源状态冲突。
• 415 Unsupported Media Type：服务器拒绝请求，因为请求实体的格式不受请求的目标资源支持。
• 429 Too Many Requests：用户已发出太多请求，在指定时间内不能再发请求。

5xx Server Error

这类状态码表示服务器在处理请求时出现了错误。

• 500 Internal Server Error：服务器遇到了一个未曾预料的情况，无法完成对请求的处理。
• 501 Not Implemented：服务器不支持请求的功能。
• 502 Bad Gateway：作为网关或代理工作的服务器从上游服务器收到了无效的响应。
• 503 Service Unavailable：服务器目前无法使用（可能是服务器过载或进行维护）。
• 504 Gateway Timeout：作为网关或代理工作的服务器从上游服务器等待响应的时间太长。
• 505 HTTP Version Not Supported：服务器不支持请求中使用的HTTP协议版本。

使用场景示例

1. 创建资源：当客户端发送一个POST请求创建一个新资源时，如果创建成功，服务器应返回201 Created状态码，并在响应头中包含新资源的URI。
2. 获取资源：如果客户端发送GET请求来获取一个存在的资源，服务器应该返回200 OK状态码和资源数据。
3. 资源不存在：如果客户端尝试访问一个不存在的资源，服务器应该返回404 Not Found状态码。
4. 资源更新：当客户端发送PUT或PATCH请求更新资源时，如果更新成功，服务器应该返回200 OK状态码。
5. 资源删除：当客户端发送DELETE请求删除资源时，如果删除成功，服务器应该返回204 No Content状态码。
6. 身份验证：如果客户端没有提供必要的身份验证信息，服务器应该返回401 Unauthorized状态码。
7. 权限不足：如果客户端尝试访问受限资源但没有足够的权限，服务器应该返回403 Forbidden状态码。
8. 服务器错误：如果服务器在处理请求时遇到问题，比如内部错误或数据库问题，应该返回500 Internal Server Error状态码。

实现细节

后端编程

在后端开发中，可以通过以下方式设置HTTP状态码：

• Node.js (Express)：

  app.get('/example', function(req, res) {
      res.status(200).send('Resource found');
  });
  

• Python (Flask)：

  from flask import Flask, jsonify, make_response
  
  app = Flask(__name__)
  
  @app.route('/example')
  def example():
      response = make_response(jsonify({'message': 'Resource found'}), 200)
      return response
  

• Java (Spring Boot)：

  import org.springframework.http.HttpStatus;
  import org.springframework.http.ResponseEntity;
  import org.springframework.web.bind.annotation.GetMapping;
  import org.springframework.web.bind.annotation.RestController;
  
  @RestController
  public class ExampleController {
  
      @GetMapping("/example")
      public ResponseEntity<String> example() {
          return new ResponseEntity<>("Resource found", HttpStatus.OK);
      }
  }
  

错误处理

为了确保能够有效地处理错误并返回适当的HTTP状态码，你可以在后端代码中实现错误处理机制。这通常涉及到使用异常处理来捕获错误，并根据错误类型设置不同的状态码。

例子：异常处理

from flask import Flask, jsonify, make_response

app = Flask(__name__)

@app.errorhandler(404)
def not_found(error):
    return make_response(jsonify({'error': 'Not found'}), 404)

@app.errorhandler(Exception)
def handle_exception(e):
    code = 500
    if isinstance(e, ValueError):
        code = 400
    return make_response(jsonify({'error': str(e)}), code)

结论

正确使用HTTP状态码对于构建健壮的Web应用和服务至关重要。
通过在代码中显式地设置状态码，你可以覆盖服务器默认的行为，并提供更具体和有意义的反馈给客户端。
此外，良好的错误处理机制可以帮助提高应用程序的稳定性和用户体验。