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 机制实现织入。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
✅ 推荐配置（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>? 重要提示：
立即学习“Java免费学习笔记（深入）”；
- 删除原 org.codehaus.mojo:aspectj-maven-plugin 声明（包括 <pluginManagement> 中的旧配置）；
- 确保 <dependency> 中的 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 相关错误
- 检查织入日志：启用 <showWeaveInfo>true</showWeaveInfo> 后，控制台将输出 Join point 'method-execution(...)' in Type ... has been woven by advice... 等信息，确认切面生效
通过以上配置，即可彻底解决 Java 11 下 AspectJ 编译失败问题，并为后续向 Java 17/21 及 Spring Boot 3.x 迁移奠定基础。
