Java中自定义异常应继承RuntimeException实现非检查型异常，命名采用“领域+异常类型”格式并提供4种标准构造方法，避免添加错误码等额外职责以保持单一性。
Java 中自定义异常继承 RuntimeException 是实现**非检查型异常（unchecked exception）** 的标准方式，适用于程序逻辑错误、非法参数、状态不一致等本应由开发者提前规避、而非强制调用方处理的场景。最优实践的核心是：语义清晰、构造灵活、轻量可读、符合 JDK 风格。
✅ 为什么选 RuntimeException 而不是 Exception？
继承 RuntimeException 表示该异常是「运行时异常」，调用方无需显式 try-catch 或 throws 声明。这符合设计原则：
- 业务逻辑错误（如订单状态非法、用户未登录）属于编程契约破坏，应快速失败，而非强迫上层吞并或透传
- 避免异常声明污染 API 接口（尤其在 Service/Controller 层），提升代码可读性和演进自由度
- 与 Spring 等主流框架默认异常处理机制（如
@ExceptionHandler）天然兼容
✅ 标准继承结构与命名规范
推荐采用「领域 + 异常类型」命名，以 Exception 结尾，并直接继承 RuntimeException（不建议多层中间类）：
public class OrderStatusInvalidException extends RuntimeException { ... }- 避免使用
Error或Throwable直接子类 —— 语义不符且易被误用 - 不加
Checked后缀（如OrderException已隐含 unchecked） - 包路径建议与对应业务类同级或置于
exception子包中（如com.example.order.exception）
✅ 必须提供的构造方法（4 种全支持）
参考 IllegalArgumentException 的 JDK 实现，提供完整构造器链，确保调用方能灵活传参：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
public class OrderStatusInvalidException extends RuntimeException {
public OrderStatusInvalidException() {
super();
}
public OrderStatusInvalidException(String message) {
super(message);
}
public OrderStatusInvalidException(String message, Throwable cause) {
super(message, cause);
}
public OrderStatusInvalidException(Throwable cause) {
super(cause);
}
}- 空参构造器便于日志或测试中简单抛出
-
String构造器支持带上下文的提示（如"Order status 'SHIPPED' cannot be reverted to 'CREATED'"） - 带
cause的构造器用于包装底层异常（如 DAO 层抛出的DataAccessException） - 不建议重写
getMessage()或添加额外字段（除非真有不可替代的业务属性，如错误码）
✅ 进阶：是否需要错误码？如何优雅支持？
纯技术异常（如空指针、数组越界）不需要错误码；但面向 API 或微服务的业务异常常需结构化错误信息。此时推荐组合而非继承：
- 定义统一错误码接口（如
ErrorCode），让异常持有该实例，而非将码写死在类名或字段里 - 例如：
new OrderStatusInvalidException(ErrorCode.ORDER_STATUS_TRANSITION_DENIED, "xxx") - 避免在异常类中加
getCode()方法——它会让异常承担「响应体构建」职责，违背单一职责 - 真正需要错误码的地方（如统一异常处理器），从异常的
getCause()或包装对象中提取，或通过异常类型映射到预设码
不复杂但容易忽略：一个干净、专注、符合直觉的 RuntimeException 子类，比堆砌功能更能降低团队理解成本和误用风险。
