AspectJ Internal Compiler Error 編譯錯誤排查指南

錯誤現象

編譯階段拋出 java.lang.StackOverflowError 或 AspectJ Internal Compiler Error，堆棧指向 org.aspectj.weaver.patterns.AndPointcut.matchInternal。

常見原因

1. 切點表達式過於複雜/遞歸：大量 &&、||、! 組合，導致編譯器模式匹配狀態爆炸。
2. AspectJ 版本與 JDK 不兼容：如 AspectJ 1.8.x 在 JDK 11+ 上運行，字節碼版本不支持。
3. 織入目標類存在異常字節碼：如 Lombok 生成的構造器、Kotlin 內部類、動態代理類干擾織入器。

排查步驟

1. 升級 AspectJ：Maven/Gradle 依賴升級至 1.9.7+（支持 JDK 17+）。
2. 簡化切點：拆分復雜 @Pointcut，避免單一表達式過長；改用 within()、execution() 精確範圍。
3. 排除問題類：在 aop.xml 或插件配置中 exclude 包含 Lombok/@Data 的實體類包路徑。
4. 啟用編譯器調試：-Xlint:ignore 抑制警告，或 -verbose 觀察織入過程定位具體類。

臨時繞過方案

若急需構建通過，可暫時禁用 AspectJ 編譯插件，改用 Spring AOP 運行時織入（@EnableAspectJAutoProxy），功能基本相容，僅性能稍弱。