Spring 6.x升级适配spring-security-cas的迁移方案咨询

1. 引入javax到jakarta的桥接依赖 #

Spring 6.x 基于 Jakarta EE 9+，而 spring-security-cas:5.8.1 仍依赖 javax.* 命名空间的API，需添加桥接依赖实现兼容：

• 若使用Spring Boot 3.x（对应Spring 6.x），直接引入官方迁移桥接starter：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jakarta-migration</artifactId>
</dependency>

• 非Spring Boot项目，手动添加核心桥接包：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jakarta-migration</artifactId>
    <version>1.0.0</version>
</dependency>
<dependency>
    <groupId>jakarta.servlet</groupId>
    <artifactId>jakarta.servlet-api</artifactId>
    <version>6.0.0</version>
    <scope>provided</scope>
</dependency>

2. 统一Spring Security版本依赖 #

spring-security-cas:5.8.1 属于Spring Security 5.8.x分支，该分支是兼容Spring 6.x的过渡版本，需确保项目中Spring Security其他模块（如spring-security-web、spring-security-config）也使用5.8.x版本，避免版本冲突：

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.security</groupId>
            <artifactId>spring-security-bom</artifactId>
            <version>5.8.1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

3. 替换配置类的命名空间引用 #

将配置类中所有javax.servlet.*、javax.security.*的导入语句，替换为jakarta.servlet.*、jakarta.security.*，CAS相关组件（如CasAuthenticationFilter、CasAuthenticationProvider）的使用逻辑保持不变，桥接依赖会自动处理命名空间转换。

示例替换：

// 原导入
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

// 替换后
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

4. 适配Servlet容器 #

若使用Tomcat作为容器，需升级到Tomcat 10.x+（对应Jakarta EE 9+），可添加Tomcat的legacy桥接包增强兼容性：

<dependency>
    <groupId>org.apache.tomcat.embed</groupId>
    <artifactId>tomcat-embed-core</artifactId>
    <version>10.1.5</version>
</dependency>
<dependency>
    <groupId>org.apache.tomcat</groupId>
    <artifactId>tomcat-jakartaee-migration</artifactId>
    <version>1.0.0</version>
</dependency>

5. 验证CAS核心流程 #

完成配置后，重点测试以下环节：

• 跳转CAS服务器登录页面
• 登录成功后的回调认证
• 单点登出流程
• 权限校验逻辑
  排查是否存在ClassNotFoundException、NoClassDefFoundError等命名空间相关异常，这类问题通常是桥接依赖遗漏或配置类替换不彻底导致。

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