Tomcat 9 UI停止命令未触发ApplicationListener问题求助

为什么Tomcat UI停止应用时不触发关闭信号？ #

Tomcat UI的「停止」按钮本质是卸载单个Web应用（undeploy），而非关闭整个Tomcat进程。你遇到的触发失效问题，大概率是以下原因：

1. Spring上下文未与Tomcat生命周期绑定：如果你的Spring上下文是手动初始化的，没有通过ContextLoaderListener或Spring Boot自动配置与Tomcat的ServletContext关联，Tomcat卸载应用时无法通知Spring执行上下文销毁逻辑，自然不会触发ContextClosedEvent、@PreDestroy等。
2. ExecutorService脱离容器管理：如果你的线程池是手动new出来的，没有交给Spring容器托管，@PreDestroy这类容器级别的销毁注解根本不会作用到它身上。
3. 非守护线程阻塞销毁流程：如果ExecutorService里的线程是非守护线程且一直在运行（比如无限循环未处理中断），Tomcat尝试销毁应用时，这些线程会阻止Web应用类加载器被回收，甚至导致Spring的销毁逻辑无法执行，形成恶性循环。
4. Runtime钩子只响应JVM关闭：Runtime.getRuntime().addShutdownHook()仅在整个JVM进程终止时触发，Tomcat卸载单个应用不会终止JVM，所以这个钩子完全无效。

可替代的应用关闭触发方式 #

1. 实现ServletContextListener（最可靠） #

这是Servlet规范定义的监听器，Tomcat在卸载应用时一定会调用contextDestroyed方法，不受Spring上下文绑定问题影响：

@WebListener // Servlet 3.0+ 可直接用注解注册，无需web.xml
public class AppShutdownListener implements ServletContextListener {

    private ExecutorService yourExecutor;

    @Override
    public void contextInitialized(ServletContextEvent sce) {
        // 初始化时获取ExecutorService实例，也可通过Spring上下文获取
        yourExecutor = (ExecutorService) sce.getServletContext().getAttribute("yourExecutor");
    }

    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        if (yourExecutor != null && !yourExecutor.isShutdown()) {
            yourExecutor.shutdown();
            try {
                // 等待5秒让任务完成，超时则强制终止
                if (!yourExecutor.awaitTermination(5, TimeUnit.SECONDS)) {
                    yourExecutor.shutdownNow();
                }
            } catch (InterruptedException e) {
                yourExecutor.shutdownNow();
                Thread.currentThread().interrupt();
            }
        }
    }
}

2. 让Spring托管ExecutorService #

把线程池交给Spring容器管理，指定销毁方法，Spring销毁上下文时会自动调用：

@Configuration
public class ExecutorConfig {

    @Bean(destroyMethod = "shutdown") // 销毁时自动调用shutdown
    public ExecutorService taskExecutor() {
        ThreadPoolExecutor executor = new ThreadPoolExecutor(
                5, 10, 60L, TimeUnit.SECONDS,
                new LinkedBlockingQueue<>()
        );
        // 可选：设置线程工厂创建守护线程，避免阻塞JVM全局关闭
        executor.setThreadFactory(r -> {
            Thread t = new Thread(r);
            t.setDaemon(true);
            return t;
        });
        return executor;
    }
}

⚠️ 注意：如果你的任务是无限循环，必须在任务逻辑中检查中断信号，否则shutdown()无法终止线程：

public class YourTask implements Runnable {
    @Override
    public void run() {
        while (!Thread.currentThread().isInterrupted()) {
            // 执行任务逻辑
            try {
                TimeUnit.SECONDS.sleep(1);
            } catch (InterruptedException e) {
                // 捕获中断后重新设置状态，退出循环
                Thread.currentThread().interrupt();
                break;
            }
        }
    }
}

3. 排查阻塞根源 #

先检查Tomcat日志（localhost.log或catalina.log），看卸载应用时是否有类加载器回收失败、死锁等警告。如果有线程阻塞问题，先修复任务逻辑中的中断处理，否则即使触发了销毁方法，线程也无法正常停止。

内容的提问来源于stack exchange，提问作者The.Laughing.Man