| """ |
| 业务异常基类模块 |
| """ |
|
|
| from __future__ import annotations |
|
|
| from typing import TYPE_CHECKING, Any |
|
|
| if TYPE_CHECKING: |
| from django.utils.functional import Promise |
|
|
| __all__: list[str] = [ |
| "BusinessException", |
| "BusinessError", |
| ] |
|
|
|
|
| class BusinessException(Exception): |
| """ |
| 业务异常基类 |
| |
| 所有自定义业务异常都应该继承此类 |
| |
| Attributes: |
| message: 错误消息(用户可读) |
| code: 错误码(用于前端判断) |
| errors: 结构化错误详情(字段级别的错误) |
| """ |
|
|
| def __init__(self, message: str | Promise, code: str | None = None, errors: dict[str, Any] | None = None) -> None: |
| """ |
| 初始化业务异常 |
| |
| Args: |
| message: 错误消息(用户可读) |
| code: 错误码(用于前端判断),默认使用类名 |
| errors: 结构化错误详情(字段级别的错误) |
| """ |
| self.message = message |
| self.code = code or self.__class__.__name__ |
| self.errors = errors or {} |
| super().__init__(str(message)) |
|
|
| def __str__(self) -> str: |
| """返回字符串表示""" |
| return f"{self.code}: {self.message}" |
|
|
| def __repr__(self) -> str: |
| """返回详细的字符串表示""" |
| return f"{self.__class__.__name__}(message={self.message!r}, code={self.code!r}, errors={self.errors!r})" |
|
|
| def to_dict(self) -> dict[str, Any]: |
| """ |
| 转换为字典(用于 API 响应) |
| |
| Returns: |
| 包含 success、code、message、error、errors 字段的字典 |
| """ |
| return { |
| "success": False, |
| "code": self.code, |
| "message": str(self.message), |
| "error": self.message, |
| "errors": self.errors, |
| } |
|
|
|
|
| class BusinessError(BusinessException): |
| """业务逻辑异常基类(向后兼容)""" |
|
|
| def __init__(self, message: str | Promise, code: str = "BUSINESS_ERROR", status: int = 400) -> None: |
| super().__init__(message, code) |
| self.status = status |
|
|
