Spring Boot：WAR部署至独立Tomcat时能否通过应用内配置自定义上下文？

核心结论 #

不能直接使用WebServerFactoryCustomizer在独立Tomcat部署场景下配置Tomcat上下文（比如RedissonSessionManager）。这个类是Spring Boot为嵌入式Tomcat设计的自动配置扩展点，当你将WAR包部署到独立Tomcat时，Spring Boot的嵌入式容器初始化逻辑不会触发，因此你定义的WebServerFactoryCustomizer Bean根本不会被执行。

你遇到问题的原因 #

你编写的WebServerFactoryCustomizer Bean仅在Spring Boot以嵌入式容器模式启动时生效。在独立Tomcat环境中，Spring Boot作为普通Web应用运行，不会触发嵌入式容器的自定义逻辑，所以RedissonSessionManager并未被正确设置到Tomcat Context中。这种配置缺失加上代码中尝试修改Context的逻辑，可能和独立Tomcat的上下文初始化流程冲突，导致出现Servlet实例等待释放或启动停滞的问题。

无需修改外部context.xml的替代方案 #

下面提供两种在应用内配置RedissonSessionManager的方法，无需修改独立Tomcat的context.xml文件：

方案1：通过ServletContextInitializer结合反射获取Tomcat Context #

利用Spring Boot的ServletContextInitializer接口，在Web应用启动时通过反射获取Tomcat的Context对象，然后设置SessionManager：

@Component
public class RedissonSessionConfigInitializer implements ServletContextInitializer {

    @Override
    public void onStartup(ServletContext servletContext) throws ServletException {
        // 从ServletContextFacade中获取Tomcat原生Context
        if (servletContext instanceof org.apache.catalina.core.ApplicationContextFacade) {
            try {
                Field contextField = org.apache.catalina.core.ApplicationContextFacade.class.getDeclaredField("context");
                contextField.setAccessible(true);
                org.apache.catalina.Context tomcatContext = (org.apache.catalina.Context) contextField.get(servletContext);

                // 初始化RedissonSessionManager并配置参数
                RedissonSessionManager sessionManager = new RedissonSessionManager();
                sessionManager.setConfigLocation("classpath:redisson-session.yaml"); // 替换为你的Redisson配置路径
                // 其他配置，比如databaseId等
                // sessionManager.setDatabaseId(0);

                tomcatContext.setManager(sessionManager);
            } catch (NoSuchFieldException | IllegalAccessException e) {
                throw new ServletException("Failed to configure RedissonSessionManager", e);
            }
        }
    }
}

注意：反射方式依赖Tomcat的内部实现，不同Tomcat版本可能存在兼容性问题，建议测试对应版本的兼容性。

方案2：使用Tomcat生命周期监听器（LifecycleListener） #

通过Tomcat的LifecycleListener监听Context的启动事件，在Context启动前设置SessionManager，这种方式兼容性更好：

public class RedissonSessionManagerListener implements org.apache.catalina.LifecycleListener {

    @Override
    public void lifecycleEvent(org.apache.catalina.LifecycleEvent event) {
        // 在Context启动前设置SessionManager
        if (org.apache.catalina.Lifecycle.BEFORE_START_EVENT.equals(event.getType()) 
            && event.getSource() instanceof org.apache.catalina.Context) {
            
            org.apache.catalina.Context context = (org.apache.catalina.Context) event.getSource();
            RedissonSessionManager sessionManager = new RedissonSessionManager();
            // 配置Redisson参数
            sessionManager.setConfigLocation("classpath:redisson-session.yaml");
            
            context.setManager(sessionManager);
        }
    }
}

然后在Spring Boot中注册这个监听器：

@Bean
public ServletContextInitializer sessionManagerListenerInitializer() {
    return servletContext -> {
        servletContext.addListener(new RedissonSessionManagerListener());
    };
}

关于你看到的错误日志 #

Catalina-utility-1 o.a.c.c.StandardWrapper INFO Waiting for [1] instance(s) to be deallocated for Servlet [grailsDispatcherServlet]
这个日志通常意味着Tomcat无法正常销毁Servlet实例，大概率是因为SessionManager配置缺失导致Session处理逻辑异常，或者存在资源泄漏（比如未关闭的连接）。使用上述方案正确配置RedissonSessionManager后，该问题应该会得到解决。

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