17370845950

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

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

定义自定义异常类

自定义异常通常继承ExceptionRuntimeException。可以根据业务场景命名,比如UserNotFoundExceptionOrderProcessException等。

示例:

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。

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