HTTP状态码详解及常见应用场景

# 1. HTTP状态码简介

- **1.1 HTTP状态码的定义及分类**
- **1.2 HTTP状态码的作用和重要性**
- **1.3 常见的HTTP状态码范围及其含义概述**

# 2. 1xx - 信息性状态码

HTTP协议中的状态码主要分为五类，1xx状态码是信息性状态码，用来传递一些关于请求状态的信息，让客户端知道接下来会发生什么。接下来我们将介绍几种常见的1xx状态码及其在实际开发中的应用场景。

### 2.1 100 Continue

**定义：**
客户端发送了一个包含Expect头部的请求，希望得到服务端的确认后再继续发送请求主体。服务端收到请求后，如果可以继续处理，则返回100状态码，客户端就可以继续发送请求主体。

**示例代码（Python）：**

from flask import Flask, request

app = Flask(__name__)

@app.route('/upload', methods=['POST'])
def upload_file():
    if 'file' not in request.files:
        return 'No file part', 400

    file = request.files['file']

    if file.filename == '':
        return 'No selected file', 400

    # Check if the file is allowed
    if allowed_file(file.filename):
        return 'OK', 100
    else:
        return 'File not allowed', 403

def allowed_file(filename):
    return '.' in filename and filename.rsplit('.', 1)[1].lower() in {'txt', 'pdf', 'png', 'jpg', 'jpeg', 'gif'}

if __name__ == '__main__':
    app.run()

**代码说明：**
- 客户端上传文件时，服务端在接收到文件后可以先进行文件类型检查。
- 如果文件类型符合要求，返回`100 Continue`，告知客户端可以继续发送文件内容。
- 如果文件类型不符合要求，返回`403 Forbidden`，拒绝客户端发送文件。

**结果说明：**
如果客户端收到`100 Continue`状态码，就知道可以继续上传文件内容，否则需要根据具体情况调整请求行为。

### 2.2 101 Switching Protocols

**定义：**
客户端发起升级协议的请求，在服务端支持的协议列表中进行协议切换。

**示例场景：**
在WebSocket通信中，客户端可以发送带有`Upgrade: websocket`头部的请求，服务端支持WebSocket协议时，会返回`101 Switching Protocols`状态码，完成协议切换，接下来双方就可以通过WebSocket进行通信。

（代码和结果说明略）

### 2.3 103 Early Hints

**定义：**
服务端开始准备响应时，可以发送一部分响应头内容，并在最后发送完整的响应。

**示例场景：**

from flask import Flask

app = Flask(__name__)

@app.route('/')
def index():
    headers = {
        'Content-Type': 'text/html',
        'Link': '<styles.css>; rel=stylesheet'
    }
    return 'Loading...', 103, headers

if __name__ == '__main__':
    app.run()

**代码说明：**
- 当访问首页时，服务端可以先发送部分响应头部分，告知浏览器可以开始加载`styles.css`样式文件。
- 客户端收到`103 Early Hints`状态码后，可以提前加载`styles.css`，加快页面展示速度。

（结果说明略）

### 2.4 1xx状态码在实际开发中的使用场景分析

在实际开发中，1xx状态码相对较少见，通常用在需要客户端和服务端进行协商、协议切换等场景中。开发人员可以根据具体需求合理运用1xx状态码，提升通信效率和用户体验。

# 3. 2xx - 成功状态码

在HTTP状态码中，2xx系列状态码表示请求被成功接收、理解、接受或处理。这些状态码表明客户端的请求是有效的，并已被服务器成功处理。以下是几个常见的2xx状态码及其含义：

#### 3.1 200 OK
- **定义**：请求已成功，请求所希望的响应头或数据体将随此响应返回。
- **场景**：最常见的成功状态码，表示服务器成功处理了请求。

# Python示例代码
import requests

url = 'https://api.example.com/data'
response = requests.get(url)

if response.status_code == 200:
    print('Request successful!')
    print(response.json()) # 响应数据
else:
    print('Failed to retrieve data.')

- **代码总结**：在请求后检查状态码是否为200，若为200则表示请求成功。可通过response.json()方法获取响应数据。

- **结果说明**：如果状态码为200，则输出"Request successful!"并打印响应数据，否则输出"Failed to retrieve data。"

#### 3.2 201 Created
- **定义**：请求已成功，并因此创建了一个新的资源。
- **场景**：常用于创建资源的POST请求，表示资源创建成功。

// Java示例代码
import java.net.HttpURLConnection;
import java.net.URL;

URL url = new URL("https://api.example.com/resource");
HttpURLConnection con = (HttpURLConnection) url.openConnectio