Java自定义异常需继承RuntimeException、用枚举定义错误码、提供三类构造函数、分离message与context字段，以实现业务错误的可识别、可追踪、可处理。

Java 中自定义异常封装错误码和错误信息，核心是让业务错误可识别、可追踪、可处理——不是简单拼字符串，而是用结构化字段承载语义，用构造逻辑保障上下文不丢失。

继承 RuntimeException，明确业务异常语义

业务异常属于流程中的正常拒绝分支（如“用户不存在”“余额不足”），不是系统崩溃。因此应继承 RuntimeException，而非 Exception：

• 避免强制调用方写 try-catch 或 throws，不污染接口契约
• Spring @Transactional 默认对 RuntimeException 回滚，便于按异常类型控制事务行为
• @RestControllerAdvice 默认只捕获非受检异常，统一拦截才生效

用枚举定义错误码，禁止硬编码字符串或数字

错误码必须结构化、可枚举、带元信息。定义一个统一的错误码枚举类，例如：

public enum BizErrorCode implements IErrorCode {
    USER_NOT_FOUND("USER_001", "用户不存在", HttpStatus.NOT_FOUND),
    ORDER_EXPIRED("ORDER_002", "订单已过期", HttpStatus.BAD_REQUEST),
    INSUFFICIENT_BALANCE("PAY_003", "余额不足", HttpStatus.PAYMENT_REQUIRED);
    
    private final String code;
    private final String message;
    private final int httpStatus;
    
    BizErrorCode(String code, String message, HttpStatus status) {
        this.code = code;
        this.message = message;
        this.httpStatus = status.value();
    }
    
    // getter 方法省略
}

好处包括：RPC 可透传、前端按 code 映射文案、监控按码统计、国际化只需换 message。

立即学习“Java免费学习笔记（深入）”；

Alibabacloud Sdk Client Initialization For Java

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

下载

提供三类构造函数，确保异常链完整

只写一个构造函数等于主动丢掉调试线索。必须覆盖三种典型场景：

• BizException(BizErrorCode code)：最简形态，用于规则拦截（如参数校验失败）
• BizException(BizErrorCode code, Throwable cause)：包装底层异常（如 DAO 抛出的 SQLException），保留原始堆栈
• BizException(BizErrorCode code, String... args)：支持动态填充提示文案（如“订单{0}不存在” → “订单12345不存在”）

每个构造函数都必须调用 super(message, cause) 或 super(message)，否则 getMessage() 返回 null，日志第一行就失效。

用 context 字段存上下文，别塞进 message

用户 ID、订单号、请求参数等现场信息，应放进 Map<String, Object> context 字段，而不是拼进 message 字符串：

• message 用于前端展示，需简洁、安全、可国际化
• context 用于日志排查和链路追踪，可包含敏感字段（但生产环境需脱敏后存入）
• 反序列化时 context 字段必须可序列化（如用 HashMap，不用 ThreadLocal）

示例用法：throw new BizException(USER_NOT_FOUND, Map.of("userId", "U8899"));