最直接有效的方式是用自定义受检异常将“必须处理”语义编译期固化:需继承Exception、类名不含“Runtime”、提供两个指定构造函数;关键方法须显式throws;异常命名须精准对应可响应业务场景;配套CI检查、基类增强和文档对齐。

要让核心团队在关键路径上主动做防御性编程,最直接有效的方式是用自定义受检异常(Checked Exception)把“必须处理”的语义编译期固化下来——不是靠文档、评审或口头约定,而是靠 Java 编译器强制拦截。
定义符合规范的受检异常类
异常类必须满足三个硬性条件,缺一不可:
- 继承 Exception,且不能是 RuntimeException 的子类(哪怕只隔一层也不行)
- 类名不带 “Runtime” 字样(如
InvalidOrderStateException可以,RuntimeInvalidOrderStateException就会被编译器忽略强制逻辑) - 至少提供两个构造函数:
public XxxException(String message)和public XxxException(String message, Throwable cause);否则调用方无法传入业务上下文或链式封装原始异常
在关键方法签名中显式声明 throws
仅定义异常类没用。必须在真正体现业务风险的方法上,用 throws 明确列出该异常类型:
- 例如:
public Order confirm(OrderDraft draft) throws InvalidOrderStateException, InsufficientStockException - 只要这个方法被其他代码调用,编译器就会立刻检查:调用处是否 try-catch 了,或者是否也在自己签名里加了 throws 向上传递
- 如果什么都没做,编译失败,报错信息直白:“unreported exception XXX; must be caught or declared to be thrown”
让异常承载可操作的业务语义
避免泛化命名(如 BusinessException),每个异常应精准对应一种可识别、可响应的风险场景:
-
PaymentTimeoutException→ 提示前端“支付超时,请重试或换方式” -
ConcurrentModificationOnInventoryException→ 触发库存补偿校验或自动重试 -
RegulatoryValidationFailedException→ 记录审计日志并阻断下单,通知合规团队
这样,开发者在写 catch 块时,自然会思考“这个情况我该怎么兜底”,而不是无差别吞掉或打印日志了事。
配套约束与引导机制
光靠编译器还不够,需辅以工程实践增强效果:
- 在 CI 流程中加入检查:禁止在 catch 块中只写
catch (Exception e) { }或e.printStackTrace() - 在公司内部异常基类中,重写
getMessage()加入建议动作(如 “请检查上游账户状态,并调用 AccountService#refreshBalance()”) - 在接口文档(如 OpenAPI)中,将这些受检异常列为
4xx响应码的明确触发条件,前后端对齐预期

















