如何在Spring Boot 3嵌入式Tomcat中配置javax至jakarta运行时转换？

核心问题分析 #

第三方库（如openws、opensaml）依赖javax包，而Spring Boot 3基于Jakarta EE规范。独立Tomcat可通过context.xml的jakartaConverter="TOMCAT"实现运行时类转换，但嵌入式Tomcat默认类加载机制会让部分第三方库被系统类加载器（ClassLoaders$AppLoader）加载，导致转换器无法生效。

可行解决方案 #

1. 配置Tomcat上下文启用Jakarta转换器

通过自定义TomcatServletWebServerFactory直接配置Context的转换器属性，并确保WebappClassLoader使用该配置：

@Configuration
public class TomcatJakartaConverterConfig {
    @Bean
    public TomcatServletWebServerFactory tomcatServletWebServerFactory() {
        return new TomcatServletWebServerFactory() {
            @Override
            protected void postProcessContext(Context context) {
                // 启用Tomcat自带的javax-to-jakarta转换器
                context.setJakartaConverter("TOMCAT");
                
                // 创建WebappLoader，指定父类加载器为应用上下文类加载器
                WebappLoader webappLoader = new WebappLoader(Thread.currentThread().getContextClassLoader());
                // 强制使用Tomcat的WebappClassLoader，确保转换器逻辑生效
                webappLoader.setLoaderClass("org.apache.catalina.loader.WebappClassLoader");
                // 关闭委托模式，优先由WebappClassLoader加载类，避免系统类加载器提前加载javax类
                webappLoader.setDelegate(false);
                
                context.setLoader(webappLoader);
                
                // 配置Jar扫描器，确保第三方库JAR被WebappClassLoader扫描到
                StandardJarScanner jarScanner = new StandardJarScanner();
                jarScanner.setScanAllDirectories(true);
                context.setJarScanner(jarScanner);
            }
        };
    }
}

2. 强制第三方库由WebappClassLoader加载

在application.properties中添加配置，调整Spring Boot的类加载过滤规则，确保openws、opensaml相关包由Tomcat的WebappClassLoader加载：

# 排除系统类加载器加载指定包，强制由WebappClassLoader处理
spring.boot.classloader.exclude-packages=org.opensaml,org.openws

3. 验证转换器生效状态

添加一个监听器类，验证类加载结果：

@Component
public class ConverterValidationListener implements ApplicationListener<ContextRefreshedEvent> {
    @Override
    public void onApplicationEvent(ContextRefreshedEvent event) {
        ClassLoader webappClassLoader = event.getApplicationContext().getClassLoader();
        try {
            // 尝试加载原javax类，若转换器生效，实际加载的是jakarta类
            Class<?> requestClass = webappClassLoader.loadClass("javax.servlet.http.HttpServletRequest");
            System.out.println("实际加载类名: " + requestClass.getName());
            System.out.println("类加载器: " + requestClass.getClassLoader().getClass().getName());
        } catch (ClassNotFoundException e) {
            e.printStackTrace();
        }
    }
}

如果输出的类名为jakarta.servlet.http.HttpServletRequest，且类加载器为org.apache.catalina.loader.WebappClassLoader，则说明转换器已生效。

注意事项 #

• 确保Spring Boot 3.0.10对应的嵌入式Tomcat版本为10.x（Spring Boot 3默认适配Tomcat 10+，该版本原生支持javax到jakarta的转换）。
• 检查第三方库的依赖scope，避免设置为system或provided，确保JAR包被打包到应用中，能被WebappClassLoader扫描到。

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