使用 spring aop 记录自定义异常日志的核心做法是定义一个切面类,利用 @afterthrowing 注解拦截指定包路径下抛出的自定义异常,并在通知方法中获取异常堆栈和上下文信息写入日志。这样可以在不侵入业务代码的前提下,统一捕获并记录特定异常的详细信息,便于后续排查问题。

如何配置切面以精准匹配自定义异常
要精准匹配自定义异常,需要在切面类的 @Aspect 声明中结合 @Pointcut 定义切入点,并在 @AfterThrowing 中指定 throwing 属性指向自定义异常类型。通过这种方式,只有当业务代码抛出继承自该自定义异常的异常时,切面才会触发,从而避免记录所有异常导致的日志噪音。

import org.aspectj.lang.annotation.AfterThrowing;
import org.aspectj.lang.annotation.Aspect;
import org.springframework.stereotype.Component;
@Aspect
@Component
public class CustomExceptionLogAspect {
@AfterThrowing(pointcut = "execution(* com.example.service..*(..)) && throw(com.example.exception.BusinessException)", throwing = "ex")
public void logBusinessException(BusinessException ex) {
System.out.println("Caught BusinessException: " + ex.getMessage());
}
}
如何在通知方法中获取请求上下文信息
在通知方法中获取请求上下文信息,可以通过注入 RequestContextHolder 或使用 JoinPoint 参数来获取当前执行的方法签名和参数。结合 HttpServletRequest 可以进一步获取用户 IP、请求 URL 等关键信息,从而构建完整的异常日志记录。

import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.AfterThrowing;
import org.aspectj.lang.annotation.Aspect;
import org.springframework.stereotype.Component;
import org.springframework.web.context.request.RequestContextHolder;
import org.springframework.web.context.request.ServletRequestAttributes;
import javax.servlet.http.HttpServletRequest;
@Aspect
@Component
public class ContextAwareExceptionLogAspect {
@AfterThrowing(pointcut = "execution(* com.example.service..*(..)) && throw(com.example.exception.BusinessException)", throwing = "ex")
public void logWithContext(JoinPoint joinPoint, BusinessException ex) {
ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
HttpServletRequest request = attributes.getRequest();
String url = request.getRequestURL().toString();
String ip = request.getRemoteAddr();
System.out.println("Exception at " + url + " from IP " + ip + ": " + ex.getMessage());
}
}
如何处理自定义异常中的嵌套异常信息
处理自定义异常中的嵌套异常信息,可以通过遍历异常的 cause 链来获取根本原因。在日志记录时,将嵌套异常的堆栈信息一并打印,有助于定位深层问题。同时,可以在自定义异常构造函数中支持传入原始异常,以便保留完整的异常链。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











