java标准自定义业务异常类应继承runtimeexception，提供code/message/cause多参构造方法、支持错误码枚举、可选实现serializable；避免强制捕获，适配spring全局处理与分布式场景。

在 Java 中编写标准的自定义业务异常类，核心是继承 RuntimeException（非检查异常），并提供语义清晰的构造方法、错误码支持和可读的提示信息，便于统一处理和日志追踪。

继承 RuntimeException，不强制上层捕获

业务异常通常属于“可预期但非程序错误”的场景（如余额不足、用户已存在），不应强迫调用方写 try-catch。因此推荐继承 RuntimeException：

• 避免污染正常业务代码逻辑
• 符合 Spring 等主流框架对业务异常的默认处理习惯（如 @ControllerAdvice 全局捕获）
• 若需检查异常（极少场景），可继承 Exception，但需显式 throws，不推荐作为“标准做法”

提供多参数构造方法，支持错误码 + 消息 + 原因

一个实用的业务异常类应能携带：唯一错误码（用于前端识别/国际化）、业务提示消息、原始异常堆栈（便于排查）。典型构造方法包括：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• BusinessException(String code, String message)
• BusinessException(String code, String message, Throwable cause)
• （可选）BusinessException(ErrorCodeEnum errorCode)，配合枚举统一管理错误码

示例片段：

public class BusinessException extends RuntimeException {
    private final String code;

    public BusinessException(String code, String message) {
        super(message);
        this.code = code;
    }

    public BusinessException(String code, String message, Throwable cause) {
        super(message, cause);
        this.code = code;
    }

    public String getCode() {
        return code;
    }
}

搭配错误码枚举，提升可维护性

把错误码和默认消息抽取为枚举，避免硬编码字符串，也方便后续做多语言或统一响应封装：

• 定义 ErrorCodeEnum，含 code、message 字段
• 自定义异常提供 BusinessException(ErrorCodeEnum) 构造方法，自动提取码和消息
• 例如：BusinessException.of(USER_NOT_FOUND) → code="USER_404", message="用户不存在"

（可选）实现序列化接口，适配分布式场景

如果异常可能跨服务传递（如 Dubbo、RPC 调用），建议实现 Serializable，并显式定义 serialVersionUID，防止反序列化失败：

• public class BusinessException extends RuntimeException implements Serializable
• private static final long serialVersionUID = 1L;（值可根据版本调整）

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南