Java中的异常处理与DDD领域驱动设计_领域模型异常的定义与边界-java教程-PHP中文网

不该抛 RuntimeException，而应抛出自定义领域异常；异常需反映领域语义、置于领域层包下、禁止继承检查型异常；Repository 不声明 throws；Application Service 仅记录日志并控制回滚；Controller 映射为语义化 HTTP 响应。

java中的异常处理与ddd领域驱动设计_领域模型异常的定义与边界

不该，但绝大多数人其实已经在用了——关键不是“能不能抛”，而是“抛什么、谁来捕获、怎么恢复”。DDD 要求异常必须反映领域语义，IllegalArgumentException 或 NullPointerException 这类 JVM 底层异常，对领域建模毫无意义。

实操建议：

每个聚合根或实体内部只抛出自定义的领域异常，如 InsufficientBalanceException、InvalidOrderStatusTransitionException
异常类必须放在领域层包下（如 com.example.banking.domain.exception），不能混在 infrastructure 或 application 层
禁止继承 RuntimeException 以外的异常基类——检查型异常（Exception 子类）会污染领域对象的 API，强迫调用方处理技术细节
构造函数里不做复杂校验；校验逻辑应封装在工厂方法或静态构造器中，失败时直接抛出领域异常

不要。Repository 是领域层契约，它的接口必须干净，不泄露数据访问细节。

常见错误现象：在 OrderRepository.findById() 上声明 throws SQLException 或 throws DataAccessException ——这等于把 JPA/Hibernate 的实现泄漏进了领域层。

实操建议：

Repository 接口方法一律不写 throws，所有底层异常都由 infrastructure 层拦截并转换为领域异常或静默处理（如返回 Optional.empty()）
当查询必然应存在却没查到时（例如根据 ID 加载已确认存在的聚合），抛 EntityNotFoundException（领域异常），而非让上层处理 EmptyResultDataAccessException
批量操作失败需区分：部分失败用 PartialUpdateException 包含成功/失败 ID 列表；全部失败才按常规领域异常处理

只做两件事：记录上下文、决定是否回滚。别在这里“修复”业务逻辑。

使用场景：用户提交转账请求，领域层抛出 InsufficientBalanceException，Application Service 不该尝试去充值或提示“请先存钱”，那是 UI 或 Domain Service 的事。

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

实操建议：

用 try-catch 捕获明确的领域异常类型，避免 catch RuntimeException 大而化之
记录日志时必须带上聚合 ID、用例输入参数（脱敏后），例如：log.warn("Transfer failed for accountId={}, targetId={}: {}", accountId, targetId, e.getMessage())
Spring 环境下，在 service 方法上加 @Transactional，并在 @Transactional(rollbackFor = DomainException.class) 显式指定回滚条件
不要在 catch 块里重新包装成 RuntimeException 向上传——上层（如 Controller）需要知道这是领域规则拒绝，不是系统故障

映射成 HTTP 语义明确的状态码和错误体，而不是堆栈或泛化消息。

容易踩的坑：把 InsufficientBalanceException 统一转成 500 Internal Server Error，或者返回 “Operation failed” 这种前端无法解析的字符串。

实操建议：

用 Spring 的 @ControllerAdvice + @ExceptionHandler 做全局映射，例如将 InsufficientBalanceException 映射为 409 Conflict，body 包含 code: "BALANCE_INSUFFICIENT" 和 message: "账户余额不足"
错误 code 必须是机器可读的常量字符串（如 "ORDER_STATUS_INVALID"），不能拼接变量或带空格
敏感字段（如账户号、金额）不出现在 error message 中；message 只用于前端展示，详情走单独的 debug_id 日志追踪
避免在 Controller 里 new 异常再 throw——领域异常必须由领域对象自己抛出，否则边界就模糊了

最常被忽略的一点：领域异常的构造函数里别放业务计算逻辑。比如在 InsufficientBalanceException 的构造里调用 account.getAvailableBalance()，万一这个 getter 本身又抛异常，你就掉进双重异常陷阱了。