自定义异常类设计与Exception继承实践

继承Exception适用于检查异常，即需要调用方显式处理的可预期错误，如用户未找到、支付失败等；而运行时异常则应继承RuntimeException，用于表示编程错误或非法状态。设计自定义异常时，首先应明确异常类型，选择合适的基类，确保分类合理；其次提供完整的构造方法，包括带消息、原因、链式异常等参数的形式，以便保留调用栈信息并支持灵活的异常封装。命名必须清晰语义化，以Exception结尾，准确表达错误本质，如InsufficientFundsException，避免模糊名称如ErrorException。可根据需要添加上下文字段，如订单号、错误码等，便于调试和错误追踪。同时避免过度设计，通过分层结构复用异常类，例如定义通用BusinessException作为父类，再派生具体异常。最后，应在Javadoc中明确说明异常触发条件，并在方法签名中声明检查异常，引导调用方正确处理，不得随意捕获而不处理或丢失异常信息。综上所述，合理的自定义异常设计应做到分类清晰、命名准确、构造完整、信息丰富、结构有序且文档齐全，从而提升系统的可读性、可维护性和错误处理的精准度。

设计自定义异常类时，继承 Exception 或其子类是常见做法。合理的异常设计能提升代码的可读性、可维护性和错误处理的精准度。以下是继承 Exception 的最佳实践，帮助你设计出清晰、实用的自定义异常。

一、明确异常的分类和用途

在定义异常前，先思考这个异常属于哪种类型，是检查异常（checked）还是运行时异常（unchecked）。

• 继承 Exception：表示这是一个检查异常，调用者必须显式处理（try-catch 或 throws）。
• 继承 RuntimeException：表示这是一个运行时异常，无需强制处理。

✅ 建议：

• 业务逻辑中可预期的、需要调用方处理的错误 → 继承 Exception
• 编程错误、非法状态、参数错误等 → 继承 RuntimeException

// 示例：检查异常，表示用户未找到
public class UserNotFoundException extends Exception {
    public UserNotFoundException(String message) {
        super(message);
    }
}

// 示例：运行时异常，表示参数非法
public class InvalidInputException extends RuntimeException {
    public InvalidInputException(String message) {
        super(message);
    }
}

二、提供有意义的构造方法

自定义异常应支持标准的异常构造方式，便于日志记录和链式异常处理。

推荐提供以下构造方法：

• MyException(String message)
• MyException(String message, Throwable cause)
• MyException(Throwable cause)
• MyException()（无参，必要时使用）

public class PaymentFailedException extends Exception {
    public PaymentFailedException() {
        super();
    }

    public PaymentFailedException(String message) {
        super(message);
    }

    public PaymentFailedException(String message, Throwable cause) {
        super(message, cause);
    }

    public PaymentFailedException(Throwable cause) {
        super(cause);
    }
}

这样可以灵活地封装底层异常，保留完整的调用栈信息。

三、命名清晰，语义明确

异常类名应以 Exception 结尾，且能清晰表达错误语义。

✅ 推荐命名：

• OrderProcessingException
• InsufficientFundsException
• ConfigurationLoadException

❌ 避免模糊命名：

• MyException
• ErrorException
• BadException

命名应体现“发生了什么错误”，而不是“哪里出错了”。

四、可选：添加上下文信息字段

如果异常需要携带额外信息（如错误码、用户ID、订单号等），可以添加字段。

public class OrderValidationException extends Exception {
    private final String orderId;
    private final String errorCode;

    public OrderValidationException(String message, String orderId, String errorCode) {
        super(message);
        this.orderId = orderId;
        this.errorCode = errorCode;
    }

    // getter 方法
    public String getOrderId() { return orderId; }
    public String getErrorCode() { return errorCode; }
}

这样调用方可以获取具体上下文，用于日志、监控或前端提示。

五、避免过度设计

不要为每个小错误都创建新异常类。合理复用或分层定义。

建议结构：

• 顶层：BusinessException extends Exception（通用业务异常）
• 子类：UserNotFoundException, PaymentFailedException 等

这样既能统一处理，又能区分具体类型。

public class BusinessException extends Exception { ... }

public class UserNotFoundException extends BusinessException { ... }

六、文档和使用建议

• 在 Javadoc 中说明异常触发条件。
• 在方法签名中声明检查异常（使用 throws），让调用方清楚风险。
• 尽量避免捕获后“吞掉”异常，应记录日志或包装后抛出。

/**
 * 根据 ID 查找用户
 * @throws UserNotFoundException 如果用户不存在
 */
public User findUserById(String id) throws UserNotFoundException {
    // ...
}

基本上就这些。设计自定义异常不复杂，但关键是要语义清晰、分类合理、信息完整。继承 Exception 本身很简单，重点在于你如何用它表达错误意图。