aspectjweaver.jar与Spring Boot冲突 Allure@Step注解无法生效

问题现象 #

正常运行的Spring Boot项目接入Allure测试报告框架时，添加可在非Spring应用生效的Maven配置后，应用启动抛出如下异常：

Caused by: java.lang.ClassNotFoundException: org.springframework.data.jpa.repository.support.SimpleJpaRepository$AjcClosure75

经定位，故障由maven-surefire-plugin中配置的aspectjweaver javaagent参数导致：移除该参数后应用可正常启动，但Allure的@Step注解会失效，无法生成对应测试步骤记录。

根因分析 #

冲突来自两个配置问题：

• 原配置直接覆写了maven-surefire-plugin的argLine参数，覆盖了Spring Boot插件、其他测试插件自动注入的JVM启动参数，破坏了Spring Boot原生类加载逻辑
• 全局挂载的aspectjweaver javaagent默认会对所有JVM加载的类执行织入，包括Spring Data JPA内部的SimpleJpaRepository等已经被Spring做过代理/织入的类，织入生成的AjcClosure内部类和Spring自身逻辑冲突，触发类找不到错误。

解决方案 #

方案1：修正AspectJ织入配置（兼容JUnit4/JUnit5，保留Allure全特性） #

如果需要依赖AspectJ实现Allure的全量注解能力，按如下方式修改maven-surefire-plugin配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.22.2</version>
    <configuration>
        <testFailureIgnore>false</testFailureIgnore>
        <!-- 必须保留@{argLine}占位符，继承其他插件注入的JVM参数 -->
        <argLine>
            @{argLine} -javaagent:"${settings.localRepository}/org/aspectj/aspectjweaver/${aspectj.version}/aspectjweaver-${aspectj.version}.jar"
        </argLine>
        <systemProperties>
            <property>
                <name>junit.jupiter.extensions.autodetection.enabled</name>
                <value>true</value>
            </property>
            <property>
                <name>allure.results.directory</name>
                <value>${project.build.directory}/allure-results</value>
            </property>
            <!-- 排除Spring、JPA等第三方框架包，避免AspectJ错误织入框架内部类 -->
            <property>
                <name>aspectj.weaver.loadtime.exclude</name>
                <value>org.springframework..*,org.hibernate..*,javax.persistence..*</value>
            </property>
        </systemProperties>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjweaver</artifactId>
            <!-- 版本和Spring Boot依赖管理的aspectj版本保持一致，不要硬编码固定版本 -->
            <version>${aspectj.version}</version>
        </dependency>
    </dependencies>
</plugin>

配置注意点：

• 不要删除@{argLine}占位符，否则会导致JaCoCo覆盖率统计、Spring Boot测试参数注入等功能失效
• aspectjweaver版本不要硬编码，和Spring Boot官方依赖管理的版本对齐，避免版本不兼容
• 可根据项目实际依赖的第三方框架调整aspectj.weaver.loadtime.exclude的排除范围，只要把不需要织入的第三方依赖包加进去即可

方案2：使用Allure JUnit5原生扩展（推荐，零AspectJ配置） #

如果测试全部基于JUnit 5（Jupiter），完全不需要配置aspectjweaver javaagent：Allure 2.9+版本已经提供JUnit5原生扩展，不需要AspectJ织入即可支持@Step、@Attachment等常用注解，从根源上避免和Spring的冲突。
配置步骤：

1. 删除maven-surefire-plugin中argLine配置里的aspectjweaver javaagent相关内容，保留@{argLine}占位符和其他系统属性配置
2. 在测试依赖中添加allure-junit5官方依赖：

<dependency>
    <groupId>io.qameta.allure</groupId>
    <artifactId>allure-junit5</artifactId>
    <version>2.20.0</version>
    <scope>test</scope>
</dependency>

3. 保留junit.jupiter.extensions.autodetection.enabled=true配置，Allure扩展会被自动识别，所有注解可正常生效。

验证方式 #

配置修改后执行mvn clean test，确认Spring测试上下文可正常启动，无类找不到异常；测试执行完成后执行mvn allure:serve，可正常打开测试报告且@Step标注的步骤正常展示，即为配置生效。

内容的提问来源于stack exchange，提问作者Лев Сабуров