Python Requests库错误处理详解：优雅地应对HTTP请求异常

# 1. HTTP请求异常概览**

HTTP请求异常是不可避免的，它们可能由网络连接问题、服务器故障或客户端错误引起。理解这些异常的类型和原因对于有效地处理它们至关重要。

HTTP状态码用于表示请求的成功或失败。它们分为五类：

* **1xx 信息性响应：**表示请求已收到，但尚未处理。
* **2xx 成功响应：**表示请求已成功处理。
* **3xx 重定向：**表示客户端需要采取进一步的操作才能完成请求。
* **4xx 客户端错误：**表示请求无效或无法被服务器处理。
* **5xx 服务器错误：**表示服务器在处理请求时遇到问题。

# 2. Requests库的错误处理机制**

HTTP请求异常是应用程序开发中不可避免的一部分。Requests库为处理这些异常提供了全面的机制，使开发人员能够优雅地处理HTTP请求错误。

**2.1 HTTP状态码的分类**

HTTP状态码是服务器对HTTP请求的响应中包含的一个三位数代码。它指示请求是否成功以及服务器的响应类型。HTTP状态码可分为以下几类：

| 类别 | 状态码范围 | 描述 |
|---|---|---|
| 成功 | 200-299 | 请求成功 |
| 重定向 | 300-399 | 请求需要重定向到另一个URL |
| 客户端错误 | 400-499 | 请求无效或无法完成 |
| 服务器错误 | 500-599 | 服务器遇到错误 |

**2.2 Requests库的异常类**

Requests库定义了几个异常类来表示不同的HTTP请求错误：

* **RequestException：**基类异常，表示所有Requests库异常。
* **ConnectionError：**连接错误，例如无法连接到服务器。
* **Timeout：**请求超时，例如服务器未在指定时间内响应。
* **HTTPError：**HTTP状态码异常，例如404 Not Found或500 Internal Server Error。
* **URLRequired：**缺少URL异常，例如未提供请求的URL。
* **TooManyRedirects：**重定向次数过多异常，例如服务器不断重定向请求。

**2.3 自定义异常处理**

除了Requests库定义的异常类外，开发人员还可以创建自定义异常类来处理特定类型的错误。例如，可以创建一个`MyCustomException`类来处理与特定API相关的错误：

class MyCustomException(Exception):
    def __init__(self, message):
        self.message = message

要使用自定义异常，需要在`try`块中捕获`RequestException`，并在捕获到特定类型的异常时引发自定义异常：

try:
    response = requests.get("https://example.com/api/v1/users")
except RequestException as e:
    if isinstance(e, HTTPError) and e.status_code == 404:
        raise MyCustomException("User not found")

通过自定义异常处理，开发人员可以创建针对应用程序特定需求的定制化错误处理机制。

# 3.1 连接错误

#### 1. 连接超时

连接超时是指在指定时间内无法建立与服务器的连接。这可能是由于网络问题、防火墙设置或服务器不可用等原因造成的。

**处理方式：**

* 使用 `timeout` 参数指定连接超时时间。
* 使用 `connect_timeout` 参数指定建立连接的超时时间。
* 捕获 `ConnectionError` 异常并进行处理。

import requests

try:
    response = requests.get("https://example.com", timeout=5)
except requests.exceptions.ConnectionError:
    print("连接超时")

#### 2. DNS解析失败

DNS解析失败是指无法将域名解析为IP地址。这可能是由于DNS服务器问题、网络问题或域名不存在等原因造成的。

**处理方式：**

* 使用 `raise_for_status()` 方法，如果DNS解析失败，则引发 `ConnectionError` 异常。
* 使用 `try...except` 块捕获 `ConnectionError` 异常并进行处理。

import requests

try:
    response = requests.get("https://example.com")
    response.raise_for_status()
except requests.exceptions.Con