Java 11 移除了 tools.jar，导致旧版 aspectj-maven-plugin（如 1.8）无法加载 com.sun:tools 依赖而编译失败；需升级至 dev.aspectj:aspectj-maven-plugin 1.13+ 并适配 JDK 11+ 构建配置。
java 11 移除了 `tools.jar`，导致旧版 `aspectj-maven-plugin`（如 1.8）无法加载 `com.sun:tools` 依赖而编译失败；需升级至 `dev.aspectj:aspectj-maven-plugin` 1.13+ 并适配 jdk 11+ 构建配置。
在将 Java 8 项目升级至 Java 11 的过程中，aspectj-maven-plugin 报错是典型兼容性问题。错误信息中关键线索为：
Could not find artifact com.sun:tools:jar:11.0.18 at specified path .../lib/tools.jar
这是因为：自 JDK 9 起，tools.jar 已被模块化取代；JDK 11 完全移除了该 JAR 文件。而旧版 org.codehaus.mojo:aspectj-maven-plugin（≤1.11）仍尝试通过 tools.jar 加载编译器工具（如 javac 内部 API），导致构建中断。
✅ 正确解决方案：切换至官方维护的 dev.aspectj 命名空间
Eclipse AspectJ 团队已于 2021 年起将 Maven 插件迁移至新坐标 dev.aspectj:aspectj-maven-plugin，该版本原生支持 JDK 11+，不再依赖 tools.jar，并基于现代 javac API 和 javax.annotation.processing 机制实现织入。
✅ 推荐配置（Maven pom.xml）
<plugin><groupid>dev.aspectj</groupid><artifactid>aspectj-maven-plugin</artifactid><version>1.13.1</version><!-- 或更高稳定版，如 1.14.0 --><configuration><source>11</source><target>11</target><compliancelevel>11</compliancelevel><showweaveinfo>true</showweaveinfo><verbose>true</verbose><xlint>ignore</xlint><encoding>UTF-8</encoding><!-- 指定 aspect 所在路径（默认 src/main/java） --><aspectdirectory>src/main/java</aspectdirectory><!-- 引入 Spring AOP 切面库 --><aspectlibraries><aspectlibrary><groupid>org.springframework</groupid><artifactid>spring-aspects</artifactid></aspectlibrary></aspectlibraries></configuration><executions><execution><goals><goal>compile</goal><goal>test-compile</goal></goals></execution></executions><!-- 必须显式声明 aspectjtools 依赖（替代已废弃的 tools.jar） --><dependencies><dependency><groupid>org.aspectj</groupid><artifactid>aspectjtools</artifactid><version>1.9.20</version><!-- 与插件版本对齐，推荐 ≥1.9.19 --></dependency></dependencies></plugin>
? 重要提示：
- 删除原 org.codehaus.mojo:aspectj-maven-plugin 声明（包括
中的旧配置）； - 确保
中的 aspectjrt 和 aspectjweaver 版本 ≥ 1.9.19（建议统一为 1.9.20），避免运行时织入异常； - 若使用 Spring Boot，还需确认 spring-boot-maven-plugin 与 AspectJ 插件执行顺序 —— 建议将 aspectj-maven-plugin 放置在 maven-compiler-plugin 之后、spring-boot-maven-plugin 之前。
⚠️ 其他兼容性注意事项
- Spring Framework 版本限制：您当前使用的 spring-framework-bom:4.0.0.RELEASE（2013 年发布）不兼容 Java 11。强烈建议升级至 Spring Framework 5.3.x（最低支持 JDK 8，完全兼容 JDK 11）或 Spring Framework 6.x（要求 JDK 17+）。否则即使 AspectJ 编译通过，Spring 容器启动仍可能因反射/字节码操作失败。
- Hibernate 版本混用风险：项目中同时存在 Hibernate 3.6（JPA 2.0）、5.0（JPA 2.1）和 5.6（JPA 2.2）——这种混合版本极易引发 ClassCastException 或 NoSuchMethodError。请统一升级至 Hibernate 5.6.x 或 6.2+（配合 Jakarta EE 9+ 命名空间）。
- javax.* → jakarta.* 迁移：Java 11+ 项目若后续升级到 Spring 6 / Jakarta EE 9+，需将所有 javax.persistence.*、javax.servlet.* 等替换为 jakarta.persistence.*、jakarta.servlet.*，并更新对应依赖（如 jakarta.persistence-api）。
✅ 验证步骤
- 清理本地仓库缓存：mvn clean dependency:purge-local-repository
- 执行编译：mvn compile —— 应无 tools.jar 相关错误
- 检查织入日志：启用
true 后，控制台将输出 Join point 'method-execution(...)' in Type ... has been woven by advice... 等信息，确认切面生效
通过以上配置，即可彻底解决 Java 11 下 AspectJ 编译失败问题，并为后续向 Java 17/21 及 Spring Boot 3.x 迁移奠定基础。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
