如何解决子类方法添加@Async注解引发的JDK代理注入异常

接口定义 #

interface IProcessor {
    void process(IRequest request);
}

实现类代码 #

@Component
public class MyProcessor implements IProcessor {

    @Async("asyncConfigBean")
    @Override
    public void process(Irequest request){
        // Some logic..
    }
}

异常信息 #

给实现类的process方法配置@Async异步执行时，抛出如下异常：

The bean 'myProcessor' could not be injected as 'com.demo.MyProcessor' becasue it is a JDK dynamic proxy that implements: com.demo.ci.IProcessor
    
Action:
Consider injecting the bean as one of its interfaces or forcing the use of CGLib-based proxies by setting proxyTargetClass=true on @EnableAsync

核心疑问 #

• 如何解决上述异常？
• 当前场景下配置proxyTargetClass=true会产生哪些影响？
• 是否存在其他解决该问题的方案？

异常根因 #

Spring默认对实现了接口的Bean做AOP增强（包括@Async、@Transactional这类注解的切面逻辑）时，会采用JDK动态代理机制。JDK动态代理生成的代理对象和原始实现类是平级关系，共同实现同一个业务接口，代理对象并不是原始实现类的子类，因此无法按照实现类MyProcessor的类型完成注入。

方案1：按接口类型注入Bean（最推荐） #

直接修改注入点的类型，声明为接口IProcessor类型即可，不需要修改任何代理配置，完全符合Spring面向接口编程的设计规范：

// 错误写法
// @Autowired
// private MyProcessor myProcessor;

// 正确写法
@Autowired
private IProcessor myProcessor;

方案2：配置proxyTargetClass=true强制使用CGLIB代理 #

在启动类的@EnableAsync注解上添加配置开启CGLIB代理：

@EnableAsync(proxyTargetClass = true)
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

该配置的影响 #

• 代理生成逻辑变化：CGLIB通过继承目标类生成子类的方式创建代理对象，生成的代理实例是MyProcessor的子类，因此可以直接按实现类类型注入。
• 使用限制：被代理的类不能是final类型，类中需要被代理的方法不能是final、private修饰的，否则子类无法重写对应方法，会导致异步逻辑失效。
• 依赖要求：原生Spring场景需要额外引入CGLIB依赖，SpringBoot 2.x及以上版本默认已经内置CGLIB，无需手动引入。
• 作用范围：该配置是全局生效的，项目中所有被@Async切面拦截的Bean，无论是否实现接口，都会采用CGLIB方式生成代理。
• 通用注意点：和JDK动态代理一样，CGLIB代理也存在同类内部方法调用不经过代理的问题，比如在MyProcessor中写一个普通方法直接调用this.process()，异步逻辑不会生效。

其他可选方案 #

• 单独配置指定Bean的代理模式：自定义AsyncAnnotationBeanPostProcessor，仅针对MyProcessor这类需要按实现类注入的Bean设置CGLIB代理，不需要全局开启proxyTargetClass，但配置繁琐，绝大多数场景没有必要。
• 手动包装异步逻辑：如果不想引入代理相关的配置，可以直接在方法内部通过自定义线程池提交任务实现异步，完全绕开Spring的AOP代理逻辑，但会丢失@Async带来的便利性，异常处理、线程池统一管控的逻辑都需要自己实现。
• 不推荐的做法：把@Async注解加到接口的方法定义上，这种写法在部分代理场景下会失效，可移植性差。

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