Java自定义业务异常应继承RuntimeException，提供code、message、args、cause构造器，显式暴露错误码与上下文，配合@ControllerAdvice统一处理，实现语义清晰、可扩展、易日志的标准化异常管理。
在 Java 中自定义业务异常类，核心是让异常既能准确表达业务语义，又便于统一处理和日志记录。关键不在于“继承 Exception 还是 RuntimeException”，而在于错误信息结构清晰、可读性强、携带上下文、支持国际化扩展。
继承 RuntimeException，避免强制 try-catch
业务异常（如“余额不足”“订单不存在”“参数非法”）通常属于程序运行中可预期的业务规则失败，不是系统故障。这类异常应继承 RuntimeException，避免污染正常业务流程的 try-catch 层级。
- 不强制上层捕获，调用方按需处理（比如 Controller 统一拦截返回友好提示）
- 避免因编译检查导致大量空 catch 或生硬 throws，保持代码简洁
- Spring 默认会将 RuntimeException 视为事务回滚触发点（可通过 @Transactional(rollbackFor) 调整）
构造器设计：支持多参数 + 错误码 + 默认提示
一个规范的业务异常类应提供多种构造方式，兼顾开发便利性与信息完整性：
- code（String）：唯一业务错误码（如 "ORDER_NOT_FOUND", "INSUFFICIENT_BALANCE"），用于前端识别、监控告警、多语言映射
- message（String）：面向开发者的简明描述（如 "Order with id {0} not found"），支持占位符便于格式化
- args（Object...）：动态填充 message 中的占位符（类似 MessageFormat.format）
- cause（Throwable）：保留原始异常链，便于排查根因（如数据库超时引发的库存校验失败）
示例构造器片段：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
立即学习“Java免费学习笔记（深入）”；
public BusinessException(String code, String message, Object... args) {
super(MessageFormat.format(message, args));
this.code = code;
}
public BusinessException(String code, String message, Throwable cause, Object... args) {
super(MessageFormat.format(message, args), cause);
this.code = code;
}
字段与方法：暴露结构化信息，支撑统一处理
除了 message 和 cause，业务异常应显式暴露 code 和可选的额外上下文（如业务 ID、请求 ID），方便全局异常处理器提取：
- 定义 final String code 字段，并提供 getter
- 可选添加 Map<String, Object> context 存储调试信息（如 orderId=12345, userId=67890）
- 重写 toString() 或新增 toLogMessage() 方法，输出含 code + message + context 的结构化日志字符串
- 避免在 message 中拼接敏感数据（如密码、身份证号），context 可设为 debug-only
配合全局异常处理器，实现错误信息标准化输出
自定义异常的价值在统一出口。Spring Boot 中推荐使用 @ControllerAdvice + @ExceptionHandler：
- 捕获所有 BusinessException，返回标准响应体（如 { "code": "ORDER_NOT_FOUND", "msg": "订单不存在", "requestId": "abc123" }）
- 通过 ResourceBundle 或 i18n 服务，根据 code 和 Locale 动态解析用户端提示文案
- 记录 ERROR 日志时，打印 code、message、context、traceId，不依赖 toString() 拼接
- 对非 BusinessException（如 NullPointerException）走另一套降级策略（返回通用错误或 500）
