Pyodide中HttpStatusError异常类的改进建议

在Pyodide项目中，HTTP请求错误处理机制最近经历了一次重要的改进。原本的HTTP错误处理方式是通过普通的OSError异常来表示，而在最新的版本中，项目引入了专门的HttpStatusError异常类来更好地处理HTTP状态码错误。

当前实现分析

目前HttpStatusError的实现存在几个值得关注的特点：

1. 它继承自OSError基类
2. 构造函数接收三个参数：状态码(status)、状态文本(status_text)和URL(url)
3. 根据状态码范围生成不同的错误消息：
   • 400-499状态码生成"Client Error"消息
   • 500-599状态码生成"Server Error"消息

现有问题

当前实现存在两个主要限制：

1. 信息丢失问题：虽然构造函数接收了状态码、状态文本和URL等信息，但这些信息仅用于构造错误消息字符串，并没有作为属性保存下来。这意味着捕获异常后无法直接访问这些原始数据，只能通过解析错误消息字符串来获取。

2. 初始化不完整：当状态码不在400-599范围内时，基类OSError的__init__方法不会被调用，这可能导致一些潜在问题。

改进建议

基础改进方案

最简单的改进是在异常类中保存原始参数：

class HttpStatusError(OSError):
    def __init__(self, status: int, status_text: str, url: str) -> None:
        self.status = status
        self.status_text = status_text
        self.url = url
        if 400 <= status < 500:
            super().__init__(f"{status} Client Error: {status_text} for url: {url}")
        elif 500 <= status < 600:
            super().__init__(f"{status} Server Error: {status_text} for url: {url}")

这种改进保留了所有原始信息，使异常处理代码能够直接访问状态码等信息，而不需要解析错误消息。

高级改进方案

更完善的方案可以借鉴requests库的做法，保存完整的请求对象：

class HttpStatusError(OSError):
    def __init__(self, status: int, status_text: str, url: str, *, req=None) -> None:
        self.req = req
        if 400 <= status < 500:
            super().__init__(f"{status} Client Error: {status_text} for url: {url}")
        elif 500 <= status < 600:
            super().__init__(f"{status} Server Error: {status_text} for url: {url}")

这种方案提供了更完整的上下文信息，但实现复杂度也更高。

特定状态码异常方案

还可以考虑为常见状态码创建特定的异常子类：

class NotFoundError(HttpStatusError):
    pass

然后通过工厂方法返回适当的异常类型。这种方案提供了最精确的错误处理能力，但实现和维护成本最高。

实际应用场景

在Pyodide的micropip组件中，开发者希望能够：

1. 在深层代码中调用raise_for_status
2. 在上层代码中捕获特定的404错误
3. 同时不捕获其他类型的HTTP错误(如500或403)

当前实现需要解析错误消息字符串才能实现这种区分，而改进后的方案可以直接通过异常属性进行判断，大大提高了代码的可读性和可维护性。

实现注意事项

无论采用哪种改进方案，都应该确保：

1. 始终调用基类的__init__方法
2. 对于不在400-599范围内的状态码，应该显式处理(如抛出AssertionError)
3. 保持向后兼容性

这些改进将使Pyodide的HTTP错误处理更加健壮和灵活，为开发者提供更好的错误诊断和处理能力。