编写适配多种输入场景的Python自定义异常的最佳实践是什么？

针对你需要支持带参数/无参数抛出的自定义异常需求，先指出当前实现的一个关键问题：直接raise CustomException是错误的——Python要求抛出异常实例而非类本身，正确的无参数抛出应该是raise CustomException()。接下来是具体的优化方案和最佳实践：

核心优化方向 #

1. 对齐内置异常行为 #

自定义异常要遵循Python内置异常的设计逻辑，确保开发者使用时符合直觉，比如异常消息能正常打印、args属性正确初始化。

2. 合理设置默认参数 #

给status和message设置合理默认值，无参数调用时也能提供清晰的异常提示，避免模糊的错误信息。

3. 可选：用类方法封装场景 #

如果有固定的异常创建模式（比如从工具返回值生成），用类方法封装可以让代码更简洁可读。

优化后的代码示例 #

基础版（满足核心需求） #

class CustomException(Exception):
    """
    自定义异常，支持两种抛出方式：
    - 带状态码和自定义消息
    - 无参数使用默认消息
    """
    def __init__(self, status=None, message=None):
        # 无消息时设置默认提示
        if message is None:
            message = "发生自定义异常"
        # 调用父类构造，确保异常的标准行为
        super().__init__(message)
        # 保存自定义属性
        self.status = status
        self.message = message

使用方式：

# 带参数抛出
raise CustomException(tool["status"], tool["message"])

# 无参数抛出
raise CustomException()

进阶版（封装场景） #

如果有重复的异常创建逻辑，可以用类方法封装，让代码更清晰：

class CustomException(Exception):
    """
    自定义异常，支持多场景抛出：
    - 从工具返回值生成（带状态码和消息）
    - 默认异常（无参数）
    """
    def __init__(self, status=None, message=None):
        if message is None:
            message = "发生自定义异常"
        super().__init__(message)
        self.status = status
        self.message = message

    @classmethod
    def from_tool(cls, tool):
        """从工具返回值创建异常"""
        return cls(status=tool["status"], message=tool["message"])

    @classmethod
    def default(cls):
        """创建默认自定义异常"""
        return cls()

使用方式：

# 从工具返回值生成异常
raise CustomException.from_tool(tool)

# 默认异常
raise CustomException.default()

关键最佳实践总结 #

• 必须抛出异常实例：永远使用raise CustomException(...)的形式，禁止直接抛出类本身，否则会导致异常捕获逻辑失效，不符合Python规范。
• 提供有意义的默认值：无参数调用时，确保异常消息清晰，帮助开发者快速定位问题。
• 正确初始化父类：调用super().__init__()时传入消息参数，保证异常的标准行为（比如str(exc)能返回正确的消息）。
• 用类方法简化场景：如果存在固定的异常创建模式，用类方法封装可以减少重复代码，提升可读性。
• 完善文档字符串：说明异常的用途、参数含义，方便团队协作时的使用和维护。

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