自定义业务异常应继承Exception类而非BaseException，最简实现为空类；需携带上下文时重写__init__保存属性并调用super().__init__(message)；可通过__str__定制用户提示，__repr__辅助调试；异常类应保持轻量，避免逻辑处理与敏感信息暴露。

如何在python中自定义异常类并传递自定义错误信息

继承 `Exception` 类是最直接的方式

Python 中所有异常都继承自 BaseException，但自定义业务异常应继承 Exception（而非 BaseException），否则会拦截系统退出、键盘中断等关键信号。

最简实现就是定义一个空类，它自动继承 __init__ 和 __str__ 行为：

class ValidationError(Exception):
    pass
<p>raise ValidationError("用户名不能为空")
</p>

这样抛出的异常会显示完整错误消息，且能被 except ValidationError: 精确捕获。

重写 `init` 以支持结构化参数

如果需要在异常中携带额外上下文（比如字段名、原始值），不要只拼接字符串，而是把信息存为实例属性。这样上层可做条件判断或日志增强：

避免覆盖父类 __init__ 时不调用 super().__init__(...)，否则 str(exc) 为空
推荐把用户可见消息传给父类，其他数据作为独立属性保存
不要在 __init__ 中做耗时操作（如网络请求、文件读取）

class ValidationError(Exception):
    def __init__(self, message, field=None, value=None):
        super().__init__(message)  # 确保 str() 可用
        self.field = field
        self.value = value
<p>exc = ValidationError("长度不能超过20", field="username", value="abc" * 10)
print(str(exc))  # "长度不能超过20"
print(exc.field) # "username"
</p>

用 `str` 或 `repr` 控制打印格式

默认情况下，print(exc) 显示的是 __str__ 返回值。如果想让异常对象在调试时更易读，可以定制它：

__str__ 应返回简洁、面向用户的错误描述（如日志输出）
__repr__ 更适合开发调试，可包含类名和关键属性（如 ValidationError(field='email', value='@') ）
不建议在 __str__ 中拼接敏感数据（如密码原文、token）

class ValidationError(Exception):
    def __init__(self, message, field=None):
        super().__init__(message)
        self.field = field
<pre class="brush:php;toolbar:false;">def __str__(self):
    if self.field:
        return f"[{self.field}] {super().__str__()}"
    return super().__str__()

raise ValidationError("格式错误", field="email")