Python捕获自定义异常提示不允许捕获未继承BaseException类错误

报错根因 #

TypeError: catching classes that do not inherit from BaseException is not allowed 报错的核心逻辑是Python解释器检测到except关键字后跟随的对象，不是继承自BaseException的合法异常类。和你先捕获requests的ConnectionError没有关联，问题基本都出在自定义异常的定义、抛出或捕获语句的写法错误上。

常见触发场景及修复方案 #

1. 异常类继承链定义错误 #

你虽然声明了自定义异常继承自Exception，但可能存在拼写错误、漏写继承参数的问题，先执行以下代码验证继承关系：

# 放在自定义异常类定义之后执行
print(issubclass(NodeError, Exception)) # 预期返回True
print(issubclass(NodeConnectionError, NodeError)) # 预期返回True
print(issubclass(NodeConnectionError, BaseException)) # 预期返回True

如果任意一项返回False，检查异常类定义是否正确：

# 错误写法（漏写继承参数）
class NodeError:
    pass

# 正确写法
class NodeError(Exception):
    pass

class NodeConnectionError(NodeError):
    pass

2. except语句后跟随异常实例而非异常类 #

这是该报错最常见的触发原因，很多人会不小心给异常类多加括号，相当于实例化了异常对象作为捕获目标，实例不是类，自然不满足继承要求：

# 错误写法（多了括号，实际是异常实例）
try:
    get_tx_count()
except NodeConnectionError():
    pass

# 正确写法（跟随异常类本身）
try:
    get_tx_count()
except NodeConnectionError as e:
    print(f"节点连接异常: {str(e)}")

3. 异常抛出语句写法错误 #

如果抛出异常时没有加括号实例化，部分场景下上层捕获会出现类型识别错误：

# 错误写法（抛出的是类而非实例）
raise NodeConnectionError

# 正确写法（实例化后抛出，可自定义错误信息）
raise NodeConnectionError(f"节点连接失败: {str(原始异常)}")

# 最佳实践：加from保留原始异常堆栈
raise NodeConnectionError(f"节点连接失败: {str(原始异常)}") from 原始异常

4. 作用域内异常类名被覆盖 #

如果在某个作用域内，你把和自定义异常类同名的变量赋值为普通对象（比如字符串、函数返回值），后续捕获时实际读取的是这个普通对象，也会触发报错：

# 错误示例：同名变量覆盖了异常类
NodeConnectionError = "连接错误"
try:
    get_tx_count()
except NodeConnectionError: # 这里实际捕获的是字符串，必然报错
    pass

你场景下的完整可运行参考代码 #

import requests

# 自定义异常定义
class NodeError(Exception):
    """节点操作异常基类"""
    pass

class NodeConnectionError(NodeError):
    """节点连接异常"""
    pass

def get_tx_count(node_url: str) -> int:
    """获取节点交易数"""
    try:
        resp = requests.get(node_url, timeout=10)
        resp.raise_for_status()
        return resp.json().get("tx_count", 0)
    except requests.exceptions.ConnectionError as e:
        # 捕获requests连接异常后抛出自定义异常
        raise NodeConnectionError(f"节点请求失败，无法连通目标节点: {str(e)}") from e

if __name__ == "__main__":
    TEST_NODE_URL = "https://你的节点地址"
    try:
        tx_count = get_tx_count(TEST_NODE_URL)
        print(f"当前节点交易数: {tx_count}")
    except NodeConnectionError as e:
        print(f"业务捕获节点异常: {str(e)}")

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