spring boot 中监听器下 onApplicationEvent 方法被执行两次问题分析及解决

最新推荐文章于 2025-04-15 06:30:00 发布

原创最新推荐文章于 2025-04-15 06:30:00 发布 · 8.1k 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#java #spring boot #spring #bug

bug 专栏收录该内容

3 篇文章

订阅专栏

本文探讨了SpringCloud项目中Kafka配置重复加载的问题。分析了项目启动时监听器执行两次的原因，并提供了三种不同的解决方案。

一、背景

项目中使用的技术栈是 spring cloud + spring boot 构建的分布式项目。
其中一个微服务下创建了一个监听者，用于项目启动时从 Apollo 中获取 kafka 的配置信息（地址、topic、等一些基本配置），然后利用加载的配置初始化 kafka。代码如下：
现在出现一个问题，项目启动的时候 onApplicationEvent() 方法每次都会执行两遍，kafka 也会初始化两遍，导致业务中发送 kafka 时会发送两遍同样的 kafka。

二、分析

可以在 onApplicationEvent() 方法中添加图一中的各种参数，图二可以查看打印出来的内容。注意：获取各种参数的语句可能会引起空指针异常比如 “event.getApplicationContext().getParent().getParent()”，可以根据自己的项目修改。
图一：

图二：
查看打印的两块内容中的“容器中参数 getSources：”内容，发现下面容器中的 “class com.example.demo.DemoApplication”是当前项目的启动类，也就是说它是通过启动类中 main() 方法传入的。而上面容器中的 “class org.springframework.cloud.stream.binder.rabbit.config.RabbitServiceAutoConfiguration” 不是当前项目中自定义的类，那么应该是第三方框架中的类。
于是用快捷键 Ctrl+N 搜索该类，发现它是因为在 pom 文件引入了该依赖< artifactId >spring-cloud-starter-bus-amqp</ artifactId> 项目启动时这个依赖包就会启动一个新的容器。如果在 pom 文件中把该依赖去掉，再启动项目会发现 onApplicationEvent() 方法只加载一次了，即上面的容器没有被加载。但显然这不是解决问题的方法，因为项目中要用到这个功能，如果项目中没有用到这个依赖可以考虑去掉，也就解决了问题。
再分析图二中的另一参数 “容器中参数 getApplicationName： ”。上面容器打印的是空字符串，下面容器打印的是“/demo”，其实下面容器中的“/demo”就是配置文件即 yml 中 server.context-path: 的值，如果 yml 中没有配置则会同上面容器一样显示空字符串。
分析图二中的参数 “容器中参数 getParent：” 和 “容器中参数 getParent.getParent：” 可以看出，其实是三个容器进行了嵌套。上面那个容器有两个父容器，下面那个容器有一个父容器。至于为什么出现这种情况可以自己看看源码、找找资料，或者有大佬评论区分享一下。

三、解决

根据上面的分析可以提供以下几种解决方案。

根据分析 3，可以看一下引起 onApplicationEvent() 方法被执行两次的依赖包项目中有没有用到，没有的话删除依赖就能解决问题。如果用到了再考虑下面的方法。
根据分析 4，可以通过下面方法解决。前提是配置文件中要有该配置。

@Component
public class DataInitializerListener implements ApplicationListener<ApplicationReadyEvent> {
	@Override
    public void onApplicationEvent(ApplicationReadyEvent event) {
	    //思路：只有加载配置文件的容器启动时才执行该方法，通过下面的判断排除掉别的容器。
       if("/demo".equals(event.getApplicationContext().getApplicationName())){
           //功能代码
           System.out.println("kafka 配置");
       }
    }
 }

根据分析 5，可以通过下面方法解决，这也是网上最常见的方法。

@Component
public class DataInitializerListener implements ApplicationListener<ApplicationReadyEvent> {
	@Override
    public void onApplicationEvent(ApplicationReadyEvent event) {
	    //思路：既然是多个容器嵌套，那么只让最外层的容器即父容器启动时执行该方法，其他的容器排除掉
       if(event.getApplicationContext().getParent().getParent() == null){
       //本人的项目中是三个容器嵌套，需要找两层父容器，如果是两个容器嵌套只需要找一层。判断条件需要改为：
       // if(event.getApplicationContext().getParent() == null){
           //功能代码
           System.out.println("kafka 配置");
       }
    }
 }

测试一下就会发现，类只加载了一遍，方法执行了两次，因此还有一种方法。

@Component
public class DataInitializerListener implements ApplicationListener<ApplicationReadyEvent> {
    private boolean flag = false;
	@Override
    public void onApplicationEvent(ApplicationReadyEvent event) {
	    //思路：加一个标记，第一个容器启动时不执行此方法，第二个容器启动时才执行。
       if(flag){
           //功能代码
           System.out.println("kafka 配置");
       }else {
           flag = true;
       }
    }
 }