SpringBoot中使用ByteBuddy实现AOP失效问题求助

从你的代码来看，整体思路是对的，但有几个关键地方可能导致AOP未生效，咱们一步步来排查：

1. 类加载时机不匹配 #

你在ApplicationEnvironmentPreparedEvent事件中安装Agent，这个时机虽然早，但Spring Boot在启动过程中已经开始加载部分业务类（比如被@Controller/@Service注解的类）。如果目标类在Agent安装前就已经被类加载器加载完成，ByteBuddy的RETRANSFORMATION策略虽然支持重新转换已加载类，但可能因为Spring的类加载器特性导致转换失效。

解决办法：把Agent安装提前到SpringApplication初始化之前，在main方法最开始执行：

public static void main(String[] args) {
    // 先安装ByteBuddy Agent，再启动Spring
    Agent.getInstance().install();
    SpringApplication application = new SpringApplication(SpringBootDemoApplication.class);
    application.run(args);
}

这样能确保所有业务类加载前就被ByteBuddy拦截处理。

2. 缺少转换日志，无法定位问题 #

你的AgentBuilder.Listener是空实现，完全看不到哪些类被转换、有没有转换错误。这会让你无法判断是匹配不到类，还是转换过程出错。

解决办法：替换成带日志的Listener：

AgentBuilder.Listener listener = new AgentBuilder.Listener.Adapter() {
    @Override
    public void onTransformation(TypeDescription typeDescription, ClassLoader classLoader, JavaModule module, boolean loaded) {
        logger.info("✅ 成功转换类: {}", typeDescription.getName());
    }

    @Override
    public void onError(String typeName, ClassLoader classLoader, JavaModule module, boolean loaded, Throwable throwable) {
        logger.error("❌ 转换类失败: {}", typeName, throwable);
    }

    @Override
    public void onIgnored(TypeDescription typeDescription, ClassLoader classLoader, JavaModule module, boolean loaded) {
        logger.debug("忽略类: {}", typeDescription.getName());
    }
};

启动后查看日志，确认目标类是否被成功转换。如果看不到目标类的转换日志，说明ElementMatcher匹配有问题。

3. ElementMatcher的匹配范围可能遗漏代理类 #

如果你的目标类是Spring Bean，Spring会为它生成动态代理类（CGLIB代理类名类似XxxService$$EnhancerBySpringCGLIB$$xxxx，JDK代理是实现类），这类代理类的类名不会以klordy.learning开头，所以会被你的nameStartsWith("klordy.learning")匹配规则漏掉。而实际请求调用的是代理类的方法，原始类的转换自然不会生效。

解决办法：调整匹配规则，直接匹配带有@CostTime注解的方法，不管所在类的名称：

new AgentBuilder.Default()
  // 匹配所有类，只要方法上有CostTime注解
  .type(ElementMatchers.any())
  .transform((builder, typeDescription, classLoader, module) -> 
      builder.visit(Advice.to(TimeAdvice.class)
          .on(ElementMatchers.isAnnotatedWith(ElementMatchers.named("klordy.learning.annotation.CostTime")))))
  .with(listener)
  .with(AgentBuilder.RedefinitionStrategy.RETRANSFORMATION)
  .installOnByteBuddyAgent();

或者更精准一点，匹配方法上有该注解的类：

.type(ElementMatchers.hasMethod(ElementMatchers.isAnnotatedWith(ElementMatchers.named("klordy.learning.annotation.CostTime"))))

4. 检查Advice的注解是否正确 #

你的TimeAdvice写法基本没问题，但有个细节可以优化：@Advice.Origin注解在OnMethodEnter中用Method类型时，可能因为类加载器的问题导致无法正确注入，建议先换成字符串类型的方法签名来验证：

@Advice.OnMethodEnter 
static long enter(@Advice.Origin String methodSignature) { 
    System.out.println("进入方法: " + methodSignature);
    return System.currentTimeMillis(); 
}

如果能看到这个日志，说明Advice已经生效，再换回Method类型也不迟。

5. 排除Spring DevTools的影响 #

如果你启用了Spring DevTools，它会使用自定义的类加载器（RestartClassLoader），ByteBuddy的Agent可能无法正确处理这个类加载器下的类。可以尝试关闭DevTools，或者在AgentBuilder中指定类加载器策略：

.with(AgentBuilder.ClassLoaderStrategy.Default.CHILD_FIRST)

最后验证步骤 #

1. 确保目标方法上确实添加了@CostTime注解；
2. 启动应用后，查看Agent的日志，确认目标类被成功转换；
3. 调用目标接口，查看控制台是否输出耗时日志。

按照这些步骤排查，应该能找到问题所在。

内容的提问来源于stack exchange，提问作者klordy