基于AspectJ的跨WAR应用Load Time Weaving织入失败排查

核心排查与解决步骤 #

按优先级逐一验证以下关键点：

1. 锁定ByteBuddyAgent的初始化时机 #

• 必须保证ByteBuddyAgent.install()在demo应用目标类（MyServiceImpl）加载前执行。如果interceptor WAR的初始化晚于demo类加载，切面完全没机会织入。
  • 建议在interceptor的启动入口（比如ServletContextListener或Spring ApplicationListener）中尽早初始化：

    @Override
    public void contextInitialized(ServletContextEvent sce) {
      ByteBuddyAgent.install();
      // 后续LTW相关逻辑
    }
    

• 验证Agent是否生效：打印ByteBuddyAgent.getInstrumentation()的返回值，确认不是空对象。

2. 校验aop.xml的配置细节 #

• 确保aop.xml放在interceptor WAR的META-INF目录下，且配置覆盖必要范围：

  <weaver options="-verbose -debug">
    <!-- 必须包含demo应用目标类所在包，否则不会扫描织入 -->
    <include within="com.demo..*"/>
    <!-- 包含切面自身所在包 -->
    <include within="com.interceptor.aspect..*"/>
  </weaver>
  <aspects>
    <aspect name="com.interceptor.aspect.MyServiceAspect"/>
  </aspects>
  

  • 务必保留options="-verbose -debug"，这是输出织入日志的关键，能直接看到是否扫描到目标类。
• 检查切点表达式是否精准匹配目标方法：
  比如正确的切点应该是：

  @Before("execution(* com.demo.service.MyServiceImpl.executeCounter(..))")
  

  注意包名、类名、方法名完全一致，(..)用于匹配任意参数列表。

3. 解决类加载器隔离问题 #

• 由于两个WAR是独立部署，Web容器会给每个WAR分配独立类加载器，必须确保：
  • AspectJ核心包（aspectjweaver.jar）放在容器共享类路径（比如Tomcat的lib目录），而非单个WAR的WEB-INF/lib，否则两个WAR无法共享织入逻辑。
  • 把interceptor的切面类所在jar也放到容器共享路径，保证织入器能同时访问切面类和demo的目标类。

4. 强制开启AspectJ日志 #

• 除了aop.xml的配置，添加JVM系统参数强制输出织入日志：

  -Dorg.aspectj.weaver.showWeaveInfo=true
  -Dorg.aspectj.weaver.verbose=true
  

  即使aop.xml加载有问题，也能通过日志确认织入器的启动状态。

5. 确认切面与LTW配置的正确性 #

• 切面类必须标注@Aspect注解，AopConfig类要明确开启LTW：

  @Configuration
  @EnableLoadTimeWeaving(aspectjWeaving = EnableLoadTimeWeaving.AspectJWeaving.ENABLED)
  public class AopConfig {
  }
  

  不要用AUTODETECT模式，避免自动检测失败导致LTW不生效。

6. 调整Web容器类加载顺序 #

• 部分容器（如Tomcat）默认先加载WAR内部的WEB-INF/lib，再加载容器共享lib。如果AspectJ相关jar放在WAR里，可能导致织入器初始化时无法访问目标类。建议把相关jar移到容器共享lib目录，避免调整类加载顺序引发其他问题。

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