通过将切点声明为抽象方法，使下游项目可继承并重写具体包路径的 pointcut 表达式，从而实现无需修改已编译 aspect jar 即可灵活适配不同包范围的日志切面能力。
通过将切点声明为抽象方法，使下游项目可继承并重写具体包路径的 pointcut 表达式，从而实现无需修改已编译 aspect jar 即可灵活适配不同包范围的日志切面能力。
在使用 AspectJ 进行编译时织入（CTW）的场景中，一个常见需求是：将通用日志切面打包为独立 Maven 依赖（如 aspectj-tool.jar），供多个业务项目复用；同时又希望各业务方能按需指定“需要被自动增强的包路径”，而非硬编码在原始切面中。由于 Java 注解值必须是编译期常量，无法通过配置或参数动态替换 @Pointcut 字符串，因此直接修改已编译 .class 中的切点表达式不可行。
核心解法是采用面向对象的抽象化设计：将切面定义为抽象类，并将可变切点声明为抽象 @Pointcut 方法。
✅ 步骤一：定义抽象基切面（发布到中央仓库）
@Aspect
public abstract class AutoLogAspect {
private static final Logger log = Logger.getLogger(AutoLogAspect.class);
// 固定切点：基于 @Log 注解的方法
@Pointcut("execution(@com.stellariver.milky.aspectj.tool.log.Log * *(..))")
public void annotationPointCut() {}
// 【关键】可变切点：由子类实现，支持任意包路径定制
@Pointcut("")
public abstract void packagePointCut();
// 统一增强逻辑，复用两个切点
@Around("annotationPointCut() || packagePointCut()")
public Object logAround(ProceedingJoinPoint pjp) throws Throwable {
long start = System.currentTimeMillis();
Object result = null;
boolean success = true;
try {
result = pjp.proceed();
} catch (Throwable t) {
success = false;
throw t;
} finally {
long cost = System.currentTimeMillis() - start;
String signature = pjp.getSignature().toShortString();
log.info(String.format(
"[success:%s] [cost:%dms] [result:%s]\n" +
"====args: %s",
success, cost, Objects.toString(result),
Arrays.stream(pjp.getArgs())
.map(Objects::toString)
.limit(6)
.collect(Collectors.joining("] [", "[", "]))
));
}
return result;
}
}⚠️ 注意：@Pointcut("") 是合法的占位写法，仅用于声明抽象方法签名，实际织入时由子类提供有效表达式。
✅ 步骤二：下游项目继承并实现具体切点
业务项目引入 aspectj-tool 依赖后，只需编写一个轻量级子类：
package com.example.myapp.aspect;
import com.stellariver.milky.aspectj.tool.log.AutoLogAspect;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Pointcut;
@Aspect
public class MyAppLogAspect extends AutoLogAspect {
// ✅ 灵活定制：此处可自由填写任意包路径，支持通配、组合等完整 AspectJ 语法
@Pointcut("within(com.example.myapp.service..*) && execution(* *(..))")
@Override
public void packagePointCut() {}
}Maven 编译时（配合 aspectj-maven-plugin），插件会自动识别该子类对抽象切点的实现，并完成织入 —— 所有 com.example.myapp.service 下的方法调用将被自动记录日志，无需额外添加 @Log 注解。
✅ 补充：运行时织入（LTW）方案（可选）
若项目采用加载时织入（Load-Time Weaving），则无需编写 Java 子类，仅需在 src/main/resources/META-INF/aop.xml 中声明：
<!DOCTYPE aspectj PUBLIC
"-//AspectJ//DTD//EN" "https://www.eclipse.org/aspectj/dtd/aspectj.dtd">
<aspectj>
<aspects>
<aspect name="com.stellariver.milky.aspectj.tool.log.AutoLogAspect"/>
<!-- 直接覆盖抽象切点 -->
<pointcut name="packagePointCut"
expression="within(com.example.myapp.controller..*) && execution(* *(..))"/>
</aspects>
</aspectj>此时甚至不依赖 aspectj-maven-plugin，仅需 JVM 启动参数 -javaagent:aspectjweaver.jar 即可生效。
✅ 总结
- ❌ 不可行：试图在已编译 JAR 中动态修改 @Pointcut 字符串（受 Java 语言限制）；
- ✅ 推荐方案：抽象切面 + 继承实现，兼顾复用性、可维护性与灵活性；
- ? 发布侧只需提供 abstract class AutoLogAspect，消费侧自由扩展；
- ? 支持 CTW 与 LTW 双模式，适配不同工程约束；
- ? 切点逻辑解耦清晰，后续还可扩展 excludePointCut()、logLevelPointCut() 等策略钩子。
该模式已在大型微服务中规模化验证，是 AspectJ 生产级模块化设计的最佳实践之一。
