首页 > 文章 > java教程

Java自定义业务异常怎么抛？

时间：2026-01-16 22:36:49 348浏览收藏

哈喽！今天心血来潮给大家带来了《Java如何抛出自定义业务异常？》，想必大家应该对文章都不陌生吧，那么阅读本文就都不会很困难，以下内容主要涉及到，若是你正在学习文章，千万别错过这篇文章~希望能帮助到你！

推荐继承 RuntimeException，因其属非检查异常，避免强制处理、契合事务回滚、便于统一拦截；业务异常本质是逻辑错误而非系统故障，无需编译器强制捕获。

在Java中如何抛出自定义业务异常_JavaException扩展应用解析

Java中抛出自定义业务异常，核心是继承 RuntimeException（非检查异常）或 Exception（检查异常），并提供语义清晰的构造函数；绝大多数业务场景应选前者，避免强制调用方写 try-catch 或 throws，干扰主流程。

为什么推荐继承 `RuntimeException` 而不是 `Exception`

业务异常本质是「程序逻辑不该走到这里」，属于可预期但非系统故障的错误（如余额不足、参数非法、状态不匹配），不是 I/O 失败或空指针这类需要强制恢复的底层问题。

Exception 子类会触发编译器强制要求处理（throws 声明或 try-catch），导致 Service 层大量模板代码，掩盖真实业务逻辑
RuntimeException 子类由上层统一拦截（如 Spring 的 @ControllerAdvice），保持各层方法签名干净
Spring 默认只对 RuntimeException 及其子类执行事务回滚，继承它能自然契合事务边界

如何设计一个实用的自定义业务异常类

关键不是堆砌功能，而是覆盖常见诉求：带错误码、支持国际化消息占位、保留原始异常上下文。

至少提供三个构造函数：BusinessException(String code, String message)、BusinessException(String code, String message, Throwable cause)、BusinessException(String code, String message, Object... args)
字段建议只保留 code（字符串，如 "USER_NOT_FOUND"）和可选的 data（用于透传额外信息，如失败的 userId）
避免重写 getMessage() 拼接逻辑——交给全局异常处理器做消息解析更灵活

public class BusinessException extends RuntimeException {
    private final String code;
    private final Map<String, Object> data = new HashMap<>();
<pre class="brush:java;toolbar:false;">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 BusinessException(String code, String message, Object... args) {
    super(String.format(message, args));
    this.code = code;
}

public String getCode() { return code; }
public Map&lt;String, Object&gt; getData() { return Collections.unmodifiableMap(data); }
public BusinessException withData(String key, Object value) {
    this.data.put(key, value);
    return this;
}

}

在 Spring Boot 中如何统一捕获并返回结构化响应

靠 @ControllerAdvice + @ExceptionHandler 拦截，但要注意两点：不要吞掉日志，不要把所有异常都塞进同一响应体。

对 BusinessException 返回 200 状态码 + 标准业务错误体（含 code、message、timestamp）
对其他未预期异常（如 NullPointerException）返回 500，并记录完整堆栈（生产环境建议关掉堆栈详情）
确保异常处理器方法不抛出新异常，否则会进入默认容器错误页

@RestControllerAdvice
public class GlobalExceptionHandler {
<pre class="brush:java;toolbar:false;">@ExceptionHandler(BusinessException.class)
public ResponseEntity&lt;ApiResponse&gt; handleBusinessException(BusinessException e) {
    log.warn("Business exception: {} - {}", e.getCode(), e.getMessage(), e);
    return ResponseEntity.ok(ApiResponse.error(e.getCode(), e.getMessage(), e.getData()));
}

@ExceptionHandler(Exception.class)
public ResponseEntity&lt;ApiResponse&gt; handleUnexpectedException(Exception e) {
    log.error("Unexpected error", e);
    return ResponseEntity.status(500).body(ApiResponse.error("SYSTEM_ERROR", "服务暂时不可用"));
}

}