升级到 Java 11 后，aspectj-maven-plugin 因依赖已移除的 tools.jar 而编译失败；需切换至官方维护的 dev.aspectj:aspectj-maven-plugin 并适配新版本（≥1.13.1），同时确保 AspectJ 运行时与编译器版本一致。
升级到 java 11 后，`aspectj-maven-plugin` 因依赖已移除的 `tools.jar` 而编译失败；需切换至官方维护的 `dev.aspectj:aspectj-maven-plugin` 并适配新版本（≥1.13.1），同时确保 aspectj 运行时与编译器版本一致。
Java 11 移除了 com.sun:tools（即 tools.jar），而旧版 org.codehaus.mojo:aspectj-maven-plugin（如 1.8 或 1.11）在底层仍尝试通过 tools.jar 加载 JDK 内部编译器 API，导致构建报错：
Could not find artifact com.sun:tools:jar:11.0.18 at specified path .../lib/tools.jar
该问题并非 POM 配置错误，而是插件本身架构不兼容 Java 9+ 模块化 JDK。自 2021 年起，AspectJ 官方已将 Maven 插件迁移至新坐标 dev.aspectj:aspectj-maven-plugin，由 Eclipse AspectJ 团队直接维护，全面支持 Java 11–21，并弃用对 tools.jar 的硬依赖。
✅ 正确配置方案（推荐）
将原 pluginManagement 中的插件声明替换为以下内容：
<plugin>
<groupId>dev.aspectj</groupId>
<artifactId>aspectj-maven-plugin</artifactId>
<version>1.13.1</version> <!-- 推荐 1.14.0+（支持 Java 21） -->
<configuration>
<source>11</source>
<target>11</target>
<complianceLevel>11</complianceLevel>
<showWeaveInfo>true</showWeaveInfo>
<verbose>false</verbose>
<Xlint>ignore</Xlint>
<encoding>UTF-8</encoding>
<aspectLibraries>
<aspectLibrary>
<groupId>org.springframework</groupId>
<artifactId>spring-aspects</artifactId>
</aspectLibrary>
</aspectLibraries>
<!-- 注意：aspectDirectory 默认为 src/main/java，可省略 -->
</configuration>
<executions>
<execution>
<goals>
<goal>compile</goal>
<goal>test-compile</goal>
</goals>
</execution>
</executions>
<!-- 必须显式声明 aspectjrt 依赖，避免版本冲突 -->
<dependencies>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjrt</artifactId>
<version>1.9.20</version> <!-- 与插件版本对齐 -->
</dependency>
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjweaver</artifactId>
<version>1.9.20</version>
</dependency>
</dependencies>
</plugin>⚠️ 关键注意事项
-
禁止混用旧坐标：彻底移除 org.codehaus.mojo:aspectj-maven-plugin 及其所有
引用（包括 aspectjrt/aspectjweaver 的旧版 1.7.x）； - 版本强一致性：aspectj-maven-plugin、aspectjrt 和 aspectjweaver 应使用相同主版本号（如 1.9.20），否则可能触发 IllegalStateException: Unsupported class file major version；
- Spring 集成适配：若使用 @EnableAspectJAutoProxy，请确认 spring-aspects 版本 ≥ 5.3（对应 Spring Framework 5.3+），旧版 Spring 4.x 对 Java 11 支持有限，建议同步升级 Spring 至 5.3.x 或更高；
-
JAXB 兼容性补充：Java 11 已移除 JAXB，默认需添加如下依赖（您已在 dependencies 中正确配置，此处强调其必要性）：
<dependency> <groupId>javax.xml.bind</groupId> <artifactId>jaxb-api</artifactId> <version>2.3.1</version> </dependency> <dependency> <groupId>org.glassfish.jaxb</groupId> <artifactId>jaxb-runtime</artifactId> <version>2.3.1</version> </dependency>
✅ 验证步骤
- 清理本地仓库中旧插件缓存：rm -rf ~/.m2/repository/org/codehaus/mojo/aspectj-maven-plugin
- 执行 mvn clean compile -X 查看是否仍有 tools.jar 相关日志；
- 检查编译输出中是否出现 Advising X classes with Y aspects —— 表示织入成功。
? 进阶提示：对于多模块项目，建议在
中统一声明插件版本，并在子模块 中仅引用（不重复配置），以保障全量一致性。 立即学习“Java免费学习笔记（深入）”；
通过以上调整，您的项目即可在 Java 11+ 环境下稳定启用 AspectJ 编译时织入，无需降级 JDK 或引入非标准 hack 方案。
