如何对Apache Camel XMPP JAR进行AspectJ编织并在WAR中生效？

DevOps 小满

2026-5-21

我之前也踩过AspectJ编织第三方JAR后没生效的坑，给你整理几个关键的排查方向和解决方案：

1. 确保AspectJ插件配置正确命中目标JAR

首先要检查你的maven-aspectj-plugin配置，核心是明确指定需要编织的第三方依赖，并且开启编织日志验证：

必须在<weaveDependencies>里添加org.apache.camel:camel-xmpp:2.20.2，告诉AspectJ要处理这个JAR里的类
开启-showWeaveInfo参数，编译时会输出哪些类被成功编织，这能直接确认XmppMessage是否被命中

示例配置：

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>aspectj-maven-plugin</artifactId>
  <version>1.14.0</version>
  <executions>
    <execution>
      <goals>
        <goal>compile</goal>
        <goal>test-compile</goal>
        <goal>weave</goal> <!-- 这个目标负责编织第三方JAR -->
      </goals>
    </execution>
  </executions>
  <configuration>
    <!-- 指定要编织的第三方依赖 -->
    <weaveDependencies>
      <weaveDependency>
        <groupId>org.apache.camel</groupId>
        <artifactId>camel-xmpp</artifactId>
        <version>2.20.2</version>
      </weaveDependency>
    </weaveDependencies>
    <!-- 开启编织日志，方便排查 -->
    <weaveOptions>
      <weaveOption>-showWeaveInfo</weaveOption>
    </weaveOptions>
    <!-- 匹配camel-xmpp依赖的JDK版本（2.20.2对应JDK 1.8） -->
    <source>1.8</source>
    <target>1.8</target>
  </configuration>
</plugin>

运行构建后，查看日志里是否有类似weaving into org.apache.camel.component.xmpp.XmppMessage的输出，如果没有，说明配置没生效。

2. 验证编织后的JAR是否被正确打包进WAR

Maven生命周期的顺序很关键，要确保AspectJ的weave目标在WAR插件的package目标之前执行：

查看构建日志的执行顺序，确认aspectj:weave在war:war之前运行
检查本地Maven仓库中org/apache/camel/camel-xmpp/2.20.2目录下的JAR，看看是否是编织后的版本（有些插件会生成带-weaved后缀的JAR，或者直接覆盖原JAR）
如果本地仓库有缓存的原始JAR，先执行mvn clean install -U强制更新，避免用旧的未编织版本

3. 检查你的Aspect切点是否正确匹配目标类

很多时候问题出在Aspect的切点表达式写错了，导致没有命中XmppMessage：

确认包名、类名拼写完全正确（比如是org.apache.camel.component.xmpp.XmppMessage，不是其他变体）
切点表达式要覆盖你想修改的方法，比如拦截所有方法的示例：

@Aspect
public class XmppMessageAspect {
    @Before("execution(* org.apache.camel.component.xmpp.XmppMessage.*(..))")
    public void interceptXmppMessageMethods(JoinPoint joinPoint) {
        // 你的增强逻辑
    }
}

还要确保这个Aspect类被AspectJ插件识别，比如所在模块被包含在插件的<sources>或者<aspectLibraries>中。

4. 确认版本兼容性

camel-xmpp 2.20.2基于JDK 1.8，所以你需要：

使用支持JDK 1.8的AspectJ版本（比如aspectj-maven-plugin 1.14.0，对应aspectjrt 1.9.7）
你的项目编译的source/target版本也要设为1.8，避免字节码版本不匹配导致编织失败

5. 反编译验证的正确姿势

有些反编译工具可能无法清晰显示AspectJ编织后的字节码，比如增强代码可能被反编译成不太直观的形式。你可以用JDK自带的javap工具查看字节码：

javap -c -v target/my-web-app-exploded-war/WEB-INF/lib/org.apache.camel-camel-xmpp-2.20.2.jar/org/apache/camel/component/xmpp/XmppMessage.class

查看输出中是否有调用你的Aspect类的代码，或者额外的静态初始化块（AspectJ织入时会添加这类代码），这比反编译更准确。

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