首页 > 文章 > java教程

自定义异常与日志记录实现方法

时间：2025-10-20 15:12:49 403浏览收藏

**自定义异常结合日志记录的实现方法：提升Java程序可维护性** 在Java开发中，**自定义异常**与**日志记录**的有效结合是提升程序健壮性和可维护性的关键。本文详细介绍了如何通过继承Exception类创建自定义异常，例如BusinessException，并在抛出或捕获异常时，利用SLF4J/Logback等**日志框架**记录关键上下文信息和完整的异常堆栈。避免信息重复输出至关重要，推荐使用`logger.error(msg, throwable)`格式确保堆栈信息完整。对于Web应用，尤其推荐在Spring Boot中使用@ControllerAdvice进行**统一异常处理**，集中记录日志，从而实现清晰的错误追踪，显著提高问题排查效率。

自定义异常结合日志框架可提升Java程序的可维护性。通过继承Exception类定义如BusinessException等异常，并在抛出或捕获时使用SLF4J/Logback记录上下文信息与堆栈，避免重复输出。关键是在异常处理中调用logger.error(msg, throwable)确保堆栈完整，推荐在Spring Boot中使用@ControllerAdvice统一处理异常并集中写日志，实现清晰的错误追踪和高效的问题排查。

Java中自定义异常如何结合日志框架记录信息

在Java中，自定义异常结合日志框架记录信息，可以有效提升程序的可维护性和问题排查效率。关键在于：抛出异常时通过日志框架输出上下文信息，同时保留异常堆栈，便于追踪。

定义自定义异常类

自定义异常通常继承Exception或RuntimeException。可以根据业务场景命名，比如UserNotFoundException、OrderProcessException等。

示例：

public class BusinessException extends Exception {
    public BusinessException(String message) {
        super(message);
    }

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

集成日志框架（如Logback/SLF4J）

使用SLF4J作为日志门面，搭配Logback实现日志输出。在异常处理的地方引入Logger，记录关键信息。

添加依赖（Maven示例）：

  org.slf4j
  slf4j-api
  1.7.36

  ch.qos.logback
  logback-classic
  1.2.11

在异常抛出和捕获时记录日志

最佳实践是在捕获异常并决定不继续处理时记录日志。避免重复打印同一异常。

示例代码：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

public class OrderService {
    private static final Logger logger = LoggerFactory.getLogger(OrderService.class);

    public void processOrder(String orderId) throws BusinessException {
        if (orderId == null || orderId.isEmpty()) {
            String errorMsg = "订单ID为空，无法处理";
            logger.error(errorMsg);
            throw new BusinessException(errorMsg);
        }

        try {
            // 模拟可能出错的操作
            int result = 10 / Integer.parseInt(orderId);
        } catch (NumberFormatException | ArithmeticException e) {
            String errorMsg = "处理订单失败，ID: " + orderId;
            logger.error(errorMsg, e); // 输出错误信息和堆栈
            throw new BusinessException(errorMsg, e);
        }
    }
}

注意：使用logger.error(msg, throwable)格式，才能完整输出异常堆栈。只传msg会丢失堆栈信息。

统一异常处理（推荐用于Web应用）

在Spring Boot等框架中，可以通过@ControllerAdvice统一捕获自定义异常，并集中写日志。

示例：

@ControllerAdvice
public class GlobalExceptionHandler {

    private static final Logger logger = LoggerFactory.getLogger(GlobalExceptionHandler.class);

    @ExceptionHandler(BusinessException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    @ResponseBody
    public String handleBusinessException(BusinessException e) {
        logger.warn("业务异常: {}", e.getMessage()); // 可以选择warn或error级别
        return "ERROR: " + e.getMessage();
    }
}

这样既记录了日志，又避免了在每个方法中重复写try-catch。

基本上就这些。关键是把自定义异常和日志配合使用，在合适的地方记录足够信息，又不重复输出。结构清晰，排查问题时就能快速定位。

到这里，我们也就讲完了《自定义异常与日志记录实现方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于自定义异常,日志框架,@ControllerAdvice,SLF4J/Logback,统一异常处理的知识点！

自定义异常日志框架 @ControllerAdvice SLF4J/Logback 统一异常处理