Spring AOP与AspectJ：拦截Logger调用的切面失效排查求助

问题背景 #

• 两个Spring Boot+Maven项目：Backend-Client（业务项目）、MonitoringSystem Backend Client（作为外部依赖，包含AOP实现）
• 原有异常上报切面正常运行，切点表达式：

@Pointcut("(within(foo.xy..*) || within(foo.doo..*)) && " +
        "!within(is(FinalType)) && " +
        "!within(is(EnumType))")

• 新增日志切面，目标捕获SLF4J/Log4j的日志调用，切点表达式：

@Pointcut("call(* org.apache.logging.log4j.Logger.*(..)) " +
        "|| call(* org.slf4j.Logger.*(..)) " +
        "|| call(* org.slf4j.LoggerFactory.*(..))")
public void loggerCalls() {}

• 已启用LoadTimeWeaving：添加@EnableLoadTimeWeaving注解，aop.xml配置完成，启动参数包含-javaagent:...\spring-instrument.jar和-Dorg.aspectj.weaver.showWeaveInfo=true
• 异常现象：新切面完全不触发，即使改用execution(public * *(..))也无效；原有切面正常运行，推测织入过程异常，且该日志切面曾正常工作后失效。

排查步骤 #

1. 验证织入日志输出 #

启动时重点查看控制台的AspectJ织入日志（由-Dorg.aspectj.weaver.showWeaveInfo=true触发）：

• 确认是否存在weaving into org.slf4j.Logger或weaving into org.apache.logging.log4j.Logger类的日志条目
• 检查是否有织入失败的错误提示（如类找不到、权限不足）
• 如果无日志框架类的织入记录，说明AspectJ未尝试对这些类进行织入

2. 检查aop.xml的织入范围 #

确认aop.xml中配置是否覆盖目标类与切面类：

• 确保<weaver>节点包含日志框架包与切面所在包，示例配置：

<weaver options="-Xlint:ignore">
    <include within="org.slf4j..*"/>
    <include within="org.apache.logging.log4j..*"/>
    <include within="your.aspect.package..*"/> <!-- 日志切面所在包 -->
</weaver>

• 排查是否存在排除规则意外屏蔽了日志框架类

3. 确认类加载顺序与JavaAgent优先级 #

• 确保spring-instrument.jar的JavaAgent参数放在所有其他Agent之前，避免日志类被其他Agent提前加载导致无法织入
• 验证项目依赖的日志框架版本与切点匹配，确认org.slf4j.Logger等类存在且路径正确
• 添加-Dorg.aspectj.weaver.verbose=true查看类加载器信息，确认日志类是否被Bootstrap类加载器加载（此类场景下Spring Instrument可能无法拦截）

4. 排查切面类配置问题 #

• 确认日志切面类标注@Component，且Backend-Client的扫描范围包含切面所在包（或通过@Import手动导入）
• 检查切面通知方法是否正确绑定切点，比如是否添加@Before("loggerCalls()")等注解，且方法参数符合要求（如包含JoinPoint）
• 对比之前正常工作的版本，排查是否修改了切面类的访问修饰符、注解配置或切点表达式拼写

5. 最小化场景测试 #

• 创建极简Spring Boot测试项目，仅引入日志框架、Spring AOP、Spring Instrument，复制当前日志切面代码验证是否能触发
• 若测试项目正常，逐步添加原有项目的依赖与配置，定位导致织入失效的因素

6. 检查Spring Boot LTW配置细节 #

• 显式指定AspectJ织入：使用@EnableLoadTimeWeaving(aspectjWeaving=AspectJWeaving.ENABLED)
• 确认application.properties/yml中无禁用LTW的配置（如spring.aop.proxy-target-class=false，虽原有切面正常，但仍需排查）

场景示例 #

日志切面类 #

@Component
@Aspect
public class LogCaptureAspect {

    private static final Logger independentLogger = LoggerFactory.getLogger("IndependentLog");

    @Pointcut("call(* org.slf4j.Logger.*(..))")
    public void slf4jLoggerCalls() {}

    @Before("slf4jLoggerCalls()")
    public void captureLogEntry(JoinPoint joinPoint) {
        String logMethod = joinPoint.getSignature().getName();
        Object[] logArgs = joinPoint.getArgs();
        // 写入独立日志文件
        independentLogger.info("Captured log: [{}] args: {}", logMethod, Arrays.toString(logArgs));
    }
}

aop.xml（放置于src/main/resources/META-INF） #

<!DOCTYPE aspectj PUBLIC
        "-//AspectJ//DTD//EN" "https://www.eclipse.org/aspectj/dtd/aspectj.dtd">
<aspectj>
    <weaver options="-Xlint:ignore">
        <include within="org.slf4j..*"/>
        <include within="com.your.aspect.package..*"/>
    </weaver>
    <aspects>
        <aspect name="com.your.aspect.package.LogCaptureAspect"/>
    </aspects>
</aspectj>

启动参数 #

-javaagent:/path/to/spring-instrument.jar
-Dorg.aspectj.weaver.showWeaveInfo=true

内容的提问来源于stack exchange，提问作者Steppe