Spring 5.x升级至6.x：第三方库javax.servlet迁移至Jakarta方案咨询

Spring 6.x基于Jakarta EE 9+规范，所有Servlet相关API已从javax.servlet迁移到jakarta.servlet包下。第三方库中实现javax.servlet.Filter的CustomFilter类，会因API包路径不匹配导致无法被Spring容器识别或加载冲突，以下是几种可行的改造/兼容方案：

1. 修改第三方库源码（适用于开源/有权限修改的场景） #

• 找到CustomFilter类的源码，将import javax.servlet.Filter;替换为import jakarta.servlet.Filter;，同步修改所有相关的Servlet API导入（比如ServletRequest、FilterChain等）
• 更新第三方库的依赖：将原有的javax.servlet:javax.servlet-api依赖替换为jakarta.servlet:jakarta.servlet-api（版本需≥5.0）
• 重新编译打包第三方库，替换项目中依赖的旧版本

2. 适配器模式（无源码修改时的最优解） #

自定义一个实现jakarta.servlet.Filter的适配器类，作为Spring容器与第三方库旧Filter之间的桥梁，核心是完成Jakarta API到javax API的适配转换：

import jakarta.servlet.*;
import java.io.IOException;

public class CustomFilterAdapter implements Filter {
    private final com.example.thirdparty.CustomFilter originalFilter;

    public CustomFilterAdapter(com.example.thirdparty.CustomFilter originalFilter) {
        this.originalFilter = originalFilter;
    }

    @Override
    public void init(FilterConfig config) throws ServletException {
        // 适配FilterConfig：将Jakarta的FilterConfig转换为javax版本
        originalFilter.init(new JavaxFilterConfigAdapter(config));
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        // 适配请求、响应和过滤器链
        originalFilter.doFilter(
                new JavaxServletRequestAdapter(request),
                new JavaxServletResponseAdapter(response),
                new JavaxFilterChainAdapter(chain)
        );
    }

    @Override
    public void destroy() {
        originalFilter.destroy();
    }

    // 内部适配类：实现javax.servlet.FilterConfig
    private static class JavaxFilterConfigAdapter implements javax.servlet.FilterConfig {
        private final jakarta.servlet.FilterConfig delegate;

        public JavaxFilterConfigAdapter(jakarta.servlet.FilterConfig delegate) {
            this.delegate = delegate;
        }

        @Override
        public String getFilterName() {
            return delegate.getFilterName();
        }

        @Override
        public javax.servlet.ServletContext getServletContext() {
            return new JavaxServletContextAdapter(delegate.getServletContext());
        }

        @Override
        public String getInitParameter(String name) {
            return delegate.getInitParameter(name);
        }

        @Override
        public java.util.Enumeration<String> getInitParameterNames() {
            return delegate.getInitParameterNames();
        }
    }

    // 同理实现JavaxServletRequestAdapter、JavaxServletResponseAdapter等适配类
    // 每个适配类负责将Jakarta对应的接口方法委托给javax接口的实现
}

• 在Spring配置中，注册CustomFilterAdapter并注入原CustomFilter实例，替代原Filter的注册逻辑

3. 使用Jakarta兼容版本的第三方库（终极方案） #

• 检查第三方库的官方发布记录，多数开源库已推出支持Jakarta EE的版本（通常版本号会带有-jakarta后缀，或直接升级大版本）
• 若找不到兼容版本，评估替换为功能相似、已适配Spring 6.x/JDK17的替代库

4. 临时过渡：使用API桥接包（仅限简单场景） #

若第三方库硬依赖javax.servlet-api，可临时引入javax.servlet:javax.servlet-api作为过渡，但这种方式可能引发类加载冲突，仅建议短期使用，不适合长期维护。

内容的提问来源于stack exchange，提问作者The java developer