Spring Boot应用监听器未被调用：为何自定义监听器不执行？

我来帮你排查这个问题，你的代码看起来没啥大问题，但有几个常见的坑可能导致监听器没触发：

1. 静态内部类的组件扫描偶发失效 #

虽然Spring支持扫描带@Component注解的静态内部类，但如果你的@SpringBootApplication类所在包结构特殊，或者组件扫描规则被自定义修改过，可能会导致这个静态内部类没被Spring识别为Bean，自然不会触发监听逻辑。

解决方案：

• 手动注册监听器，绕过组件扫描：在main方法里添加一行代码，直接把监听器实例注册到Spring应用中：

application.addListeners(new T());

• 或者把监听器改成独立类，放在@SpringBootApplication所在的包或子包下，这样组件扫描肯定能精准找到它。

2. ContextRefreshedEvent触发时机早于预期 #

ContextRefreshedEvent是在Spring应用上下文完全刷新完成后触发的，这个时机其实在SpringApplication.run()方法返回前就已经发生了。如果你的System.out.println输出没被看到，大概率是控制台日志被其他输出覆盖，或者System.out被重定向/拦截了。

解决方案：

• 换成Spring官方推荐的SLF4J日志组件，输出更可靠，还能通过日志级别控制查看：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

// ...

private static final Logger logger = LoggerFactory.getLogger(T.class);

@Override
public void onApplicationEvent(ContextRefreshedEvent event) {
    logger.info("监听器已触发！");
}

• 可以在run方法返回后，手动验证监听器Bean是否存在，确认是否被正确注册：

T listener = run.getBean(T.class);
System.out.println("监听器Bean是否存在：" + (listener != null));

3. 特殊配置或版本影响上下文刷新流程 #

在部分Spring Boot版本中，如果设置了WebApplicationType.NONE（非Web应用），或者自定义了ApplicationContextInitializer，可能会干扰上下文刷新的流程，导致ContextRefreshedEvent没有被触发。

解决方案：

• 检查是否在代码中设置了application.setWebApplicationType(WebApplicationType.NONE)，如果不是刻意需要非Web环境，去掉这个配置。
• 如果使用的是较旧的Spring Boot 1.x版本，建议升级到稳定的2.x版本，这类兼容性问题会少很多。

快速验证方案 #

先试试手动注册监听器的方式，修改你的main方法：

public static void main(String[] args) throws UnknownHostException {
    SpringApplication application = new SpringApplication(Application.class);
    // 手动添加监听器实例
    application.addListeners(new T());
    ConfigurableApplicationContext run = application.run(args);
    // 验证监听器是否被加载
    System.out.println("监听器Bean实例：" + run.getBean(T.class));
}

如果这样能看到"test"输出，说明之前是组件扫描没生效；如果还是没输出，那肯定是日志输出的问题，换成SLF4J日志再试。

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