Archived
snowy-yang
d7d3cfce69
为什么：core/aiohttp_compat.py 与 core/sync_http.py 各自定义了一份 RequestException / HTTPError，是**两个不同的类**。调用方在同步段捕获 core.sync_http.HTTPError、异步段抛的却是 core.aiohttp_compat.HTTPError， 两者无继承关系——异常会穿透所有 except 分支，属于隐藏的跨层 bug。 改法：新建 core/http_errors.py 作为唯一定义处（RequestException 基类 + HTTPError / Timeout / ConnectionError），两个垫片改为从它导入并再导出。 刻意保留 requests 的命名约定（Timeout / ConnectionError 与内置同名， 调用方需带模块前缀引用），已在 docstring 写明，避免后来者误改。 注意：sync_http 补了 __all__ 显式再导出——models._RetryFromScratch 继承它、 tests/test_aria2.py 直接导入它，符号必须保持可导入。
39 lines
1.4 KiB
Python
39 lines
1.4 KiB
Python
# -*- coding: utf-8 -*-
|
||
"""requests 同形异常层次（同步 / 异步两个 HTTP 垫片共用）。
|
||
|
||
`core.aiohttp_compat`（异步）与 `core.sync_http`（同步）此前各自定义了一份
|
||
`RequestException` / `HTTPError`——两份定义互不相干，于是同一条调用链上
|
||
「同步段抛的异常捕获不到异步段的同类失败」，调用方被迫记住自己走的是哪条垫片。
|
||
|
||
此处收敛为唯一来源；命名沿用 requests（`Timeout` / `ConnectionError` 与内置
|
||
异常同名，这是 requests 自身的约定——调用方应带模块前缀引用，例如
|
||
`requests.ConnectionError`，裸 `ConnectionError` 会命中内置的那个）。
|
||
|
||
层次：
|
||
RequestException 网络 / 协议层失败（可捕获的总入口）
|
||
├── HTTPError raise_for_status() 抛出的状态异常（携带 response）
|
||
├── Timeout 请求超时
|
||
└── ConnectionError 连接错误
|
||
"""
|
||
from typing import Any
|
||
|
||
|
||
class RequestException(Exception):
|
||
"""请求异常基类（网络/协议层）。"""
|
||
|
||
|
||
class HTTPError(RequestException):
|
||
"""raise_for_status() 抛出的 HTTP 状态异常。"""
|
||
|
||
def __init__(self, message: str, response: Any = None):
|
||
super().__init__(message)
|
||
self.response = response
|
||
|
||
|
||
class Timeout(RequestException):
|
||
"""请求超时。"""
|
||
|
||
|
||
class ConnectionError(RequestException):
|
||
"""连接错误。"""
|