Spring Boot迁移至Jakarta EE后，如何解决Shibboleth IdP的javax兼容问题？

1. 字节码工具批量转换javax到jakarta #

• 用OpenRewrite或Eclipse Transformer这类工具，直接对Shibboleth的JAR包做字节码层面的替换，把所有javax.*引用改成jakarta.*。
• Eclipse Transformer示例命令：

  java -jar transformer-cli-1.1.0.jar --input ./shibboleth-idp-libs --output ./shibboleth-idp-jakarta-libs --rules jakarta
  

• 转换完成后，用新生成的JAR包替换项目里原有的Shibboleth依赖。

2. 调整项目依赖配置 #

• 在Maven/Gradle里排除Shibboleth依赖中所有javax.*的传递依赖，避免冲突。
  Maven示例：

  <dependency>
      <groupId>org.opensaml</groupId>
      <artifactId>opensaml-core</artifactId>
      <version>3.4.6</version>
      <exclusions>
          <exclusion>
              <groupId>javax.servlet</groupId>
              <artifactId>javax.servlet-api</artifactId>
          </exclusion>
          <!-- 按需排除其他javax类库 -->
      </exclusions>
  </dependency>
  

• 引入对应的Jakarta EE替代依赖，比如jakarta.servlet:jakarta.servlet-api:6.0.0。

3. 手动适配核心扩展类 #

• 对字节码转换无法完全处理的类（比如自定义的Shibboleth过滤器、监听器），手动修改代码：把javax.servlet.*相关的API替换成jakarta.servlet.*的对应实现。
• 示例：将原实现javax.servlet.Filter的类，改为实现jakarta.servlet.Filter，并重写方法时使用Jakarta的请求、响应对象。

4. 配置Tomcat 10容器 #

• 在Tomcat的context.xml里添加资源配置，确保转换后的Shibboleth组件能被正确加载：

  <Resources>
      <PostResources className="org.apache.catalina.webresources.JarResourceSet"
                    base="./shibboleth-idp-jakarta-libs/shibboleth-idp-core.jar"
                    webAppMount="/WEB-INF/lib/shibboleth-idp-core.jar"/>
  </Resources>
  

• 调整Tomcat类加载优先级，让转换后的Jakarta版本依赖优先被加载。

5. 全流程测试验证 #

• 启动应用后，完整测试SSO流程：身份发起请求、认证回调、会话创建与销毁等环节，排查是否存在ClassNotFoundException或NoSuchMethodError这类兼容性异常。
• 重点验证涉及HTTP请求处理、会话存储的Shibboleth核心组件是否正常工作。

内容的提问来源于stack exchange，提问作者Rajesh Reddy Ananthula