无法捕获requests.exceptions.ConnectionError的技术求助

核心排查方向 #

1. 多版本requests导致异常类不匹配 #

这是最常见的原因：如果环境中存在多个requests实例（比如虚拟环境外的全局版本和项目内版本冲突），抛出的ConnectionError异常类和你捕获的并非同一个对象，导致except块无法匹配。

验证方法：在捕获所有异常的块中打印异常类型的模块路径，和目标捕获类对比：

import requests

try:
    requests.get("私有API地址")
except Exception as e:
    # 打印抛出的异常类型及其模块
    print(f"抛出的异常类型: {type(e)}, 模块路径: {type(e).__module__}")
    # 打印当前requests引用的ConnectionError类及其模块
    print(f"目标捕获类: {requests.exceptions.ConnectionError}, 模块路径: {requests.exceptions.ConnectionError.__module__}")

如果两者模块路径不一致，说明存在多版本冲突。解决方法：清理虚拟环境，重新安装指定版本：

pip uninstall -y requests
pip install requests==2.25.1

2. 异常在子线程/异步协程中抛出 #

如果私有API的调用逻辑是在子线程或异步协程中执行的，外层的try-except无法捕获跨线程/协程的异常。比如用threading.Thread启动的请求，异常会直接输出到控制台，而不会被主线程的try块捕获。

解决方法：在子线程/协程的内部代码中添加try-except块，或者使用线程的异常传递机制（比如自定义线程类捕获异常）。

3. 请求发送逻辑未完全包裹在try块内 #

确认你的try块完全包裹了请求发送的核心代码，不要把requests.get()/requests.post()的调用拆分到try块外：
❌ 错误示例：

req = requests.Request("GET", "私有API地址")
# 发送请求不在try块内
response = req.send()

✅ 正确示例：

try:
    response = requests.get("私有API地址")
except requests.exceptions.ConnectionError as e:
    # 处理异常
    print(f"捕获到连接错误: {e}")

4. 验证异常捕获范围 #

尝试先捕获更上层的异常类，确认是否能捕获到目标异常，再缩小范围：

try:
    requests.get("私有API地址")
except requests.exceptions.RequestException as e:
    # RequestException是所有requests异常的父类
    print(f"捕获到请求异常: {type(e)}, 内容: {e}")
except Exception as e:
    print(f"捕获到未知异常: {type(e)}, 内容: {e}")

如果能被RequestException或Exception捕获，但不能被ConnectionError捕获，回到第一个排查点，确认异常类的匹配问题。

内容的提问来源于stack exchange，提问作者Tilman