如何捕获嵌套的httpx超时异常？TimeoutError未触发原因解析

为什么TimeoutError无法捕获该异常 #

Python的异常捕获机制是精确匹配异常类型（或其子类），你当前捕获的是Python标准库中的TimeoutError（属于OSError的子类），但httpx最终抛出的是它自身封装的httpx.ReadTimeout异常——这是httpx自定义的异常类，和标准TimeoutError没有继承关系，因此不会被你的except TimeoutError分支命中。

从异常栈可以清晰看到异常的包装链：

• 底层触发标准TimeoutError
• 被httpcore封装为httpcore.ReadTimeout
• 最终被httpx再次封装为httpx.ReadTimeout抛出
  标准TimeoutError只是作为异常的__cause__（原因链）存在，并非直接抛出的异常对象，自然不会被针对它的捕获分支处理。

正确的捕获方式 #

有两种精准且实用的捕获方案：

方案1：针对性捕获httpx超时异常 #

直接捕获httpx提供的超时类异常，这是最推荐的方式：

with httpx.Client(**sessions[scraperIndex]) as client:
    try:
        response = client.get(...)
    except httpx.ReadTimeout as e:
        print('读取阶段超时触发')
    except httpx.TimeoutException as e:
        print('任意httpx超时场景触发（含连接超时、读取超时等）')
    except Exception as e:
        print(f'⛔️ Unexpected exception: {e}')
        print_exc()

• httpx.ReadTimeout：专门匹配读取响应阶段的超时
• httpx.TimeoutException：所有httpx超时类异常的父类，可覆盖所有超时场景

方案2：捕获底层系统级异常（不推荐） #

如果一定要捕获底层的TimeoutError，可以用except OSError as e，但这会同时捕获所有系统级错误（如网络断开、权限不足等），范围过宽，容易误判其他异常，因此不建议使用。

推导逻辑 #

1. 观察异常栈的顶层：最终触发except Exception的是httpx.ReadTimeout，这是直接抛出的异常对象。
2. 异常栈中的The above exception was the direct cause of the following exception说明，标准TimeoutError只是该异常的触发原因，并非直接抛出的异常。
3. 结合httpx的设计逻辑：httpx会将底层httpcore的异常映射为自身的异常体系，httpx.ReadTimeout继承自httpx.TimeoutException，与标准TimeoutError无继承关系，因此无法被except TimeoutError匹配。

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