类实现双接口时@PostConstruct注解方法被多次调用问题咨询

这种情况我之前在项目里踩过坑！你遇到的@PostConstruct方法被多次调用的问题，大概率和你的类实现了两个接口有关，咱们一步步拆解原因和解决办法：

问题根源 #

当你的类实现多个接口时，Spring默认会使用JDK动态代理（基于接口生成代理）。这时候Spring会为每个接口都创建一个代理实例，每个代理实例初始化时都会触发标注了@PostConstruct的方法——哪怕你实际的目标Bean只有一个，最终就导致了方法被多次执行。

可行的解决思路 #

• 改用CGLIB类代理：如果你的业务允许（不需要严格基于接口代理），可以强制Spring使用基于类的CGLIB代理，这样只会生成一个代理对象，@PostConstruct自然只会执行一次。

  • Spring Boot项目可以在配置文件里加：spring.aop.proxy-target-class=true
  • 非Boot项目可以用注解开启：@EnableAspectJAutoProxy(proxyTargetClass = true)

• 迁移初始化逻辑到其他地方：如果不想改代理方式，也可以把@PostConstruct里的逻辑转移到：

  • 类的构造方法（注意：构造方法里不要依赖其他尚未初始化完成的Bean，否则会出现依赖问题）
  • 自定义BeanPostProcessor：实现这个接口，在postProcessAfterInitialization方法里执行初始化逻辑，这个方法只会在目标Bean初始化完成后执行一次

• 排查是否存在多个Bean实例：有时候可能是你的类被重复注册成Bean了（比如重复的@Component扫描路径、XML里重复定义Bean）。可以通过以下代码检查：

  // 在任意Bean中注入ApplicationContext
  @Autowired
  private ApplicationContext context;
  
  public void checkBeanCount() {
      Map<String, YourClass> beans = context.getBeansOfType(YourClass.class);
      System.out.println("当前Bean数量：" + beans.size());
  }
  

  如果数量大于1，就需要清理重复的Bean定义啦。

额外提醒 #

如果你的类同时还实现了InitializingBean接口，它的afterPropertiesSet方法也会遇到同样的多次调用问题，解决思路和上面一致哦。

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