从javax EE迁移至Jakarta EE遇第三方旧库兼容编译错误求助

• 适配器模式
  编写适配类，将Jakarta的API对象转换成旧库要求的javax类型。以ServletConfig为例：

  public class JakartaToJavaxServletConfigAdapter implements javax.servlet.ServletConfig {
      private final jakarta.servlet.ServletConfig delegate;
  
      public JakartaToJavaxServletConfigAdapter(jakarta.servlet.ServletConfig delegate) {
          this.delegate = delegate;
      }
  
      @Override
      public String getServletName() {
          return delegate.getServletName();
      }
  
      @Override
      public javax.servlet.ServletContext getServletContext() {
          // 需同步实现ServletContext的适配类，逻辑与上述一致
          return new JakartaToJavaxServletContextAdapter(delegate.getServletContext());
      }
  
      @Override
      public String getInitParameter(String name) {
          return delegate.getInitParameter(name);
      }
  
      @Override
      public Enumeration<String> getInitParameterNames() {
          return delegate.getInitParameterNames();
      }
  }
  

  调用旧库方法时，用适配器包装Jakarta对象传入：

  jakarta.servlet.ServletConfig jakartaConfig = ...;
  oldLibraryMethod(new JakartaToJavaxServletConfigAdapter(jakartaConfig));
  

• 尝试桥接依赖
  部分Jakarta EE兼容容器提供javax到jakarta的桥接jar包，可将javax API的请求转发至jakarta实现。但针对这种停更多年的旧库，必须测试验证兼容性，避免隐性问题。

• 修改旧库字节码
  使用ASM、Byte Buddy等字节码工具，批量替换旧库class文件中的javax.为jakarta.，重新打包成jar替换原有依赖。注意：

  • 先备份原库文件，防止操作失误损坏依赖
  • 若旧库存在硬编码的包名字符串（如日志输出、配置路径），替换时需避开这类内容
  • 修改后需全面测试，确保旧库功能正常运行

• 封装旧库逻辑
  将所有依赖旧库的代码单独封装为独立模块，该模块内部保留javax依赖，项目其他部分使用jakarta。为封装模块定义统一接口，让项目主体通过接口与旧库模块交互，避免直接传递javax或jakarta类型对象，以此隔离冲突。

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