CAS单点登录避坑指南：Spring Security客户端配置中的5个常见错误与解决方案

CAS单点登录实战避坑：Spring Security客户端配置深度解析

当你第一次将CAS客户端集成到Spring Security项目中时，那种看到浏览器陷入重定向循环的绝望感，相信很多开发者都深有体会。CAS单点登录本应简化认证流程，但配置不当反而会让系统变得比传统登录更复杂。本文将带你直击五个最常见的配置陷阱，这些坑点往往不会在基础教程中提及，却能让整个单点登录系统彻底瘫痪。

1. 重定向循环：Service属性与过滤器的死亡之舞

重定向循环是CAS客户端配置中最令人崩溃的问题之一。浏览器在客户端和服务端之间无限跳转，最终以"ERR_TOO_MANY_REDIRECTS"告终。这种情况通常源于ServiceProperties配置与过滤器链的微妙冲突。

核心矛盾点在于：

• serviceProperties.setService()必须与CasAuthenticationFilter监听的URL完全匹配
• 但该URL又必须能被Spring Security的permitAll规则放行

一个典型的错误配置如下：

@ServiceProperties serviceProperties() {
    ServiceProperties properties = new ServiceProperties();
    properties.setService("https://client.example.com/login"); // 与实际过滤器路径不一致
    return properties;
}

修正方案需要三重验证：

1. 检查application.yml中cas.client.login的路径
2. 确保ServiceProperties的service值与之完全一致
3. 在WebSecurityConfig中为该路径配置permitAll