Win10下Apereo CAS SSO服务器搭建后续步骤及运行问题咨询

一、CAS启动进程卡在96%的排查方案 #

• 查看启动日志：检查控制台输出或项目目录下logs文件夹内的CAS日志，定位是否有配置错误（如未配置的数据库/LDAP依赖、端口冲突）。常见情况是默认启用了某些认证模块但未配置参数，导致初始化阻塞。
• 调整内存分配：在项目根目录的gradle.properties中添加参数：org.gradle.jvmargs=-Xmx2048m -XX:MaxMetaspaceSize=512m，增加Gradle启动时的堆内存，避免资源不足导致卡顿。
• 检查端口占用：执行命令netstat -ano | findstr 8080，确认8080端口是否被其他服务占用（如本地Tomcat），若冲突可修改CAS端口：在application.properties中添加server.port=8081。
• 简化配置：暂时禁用不必要的模块，比如删除build.gradle中未配置的依赖（如cas-server-support-jdbc），用最基础的CAS配置启动测试。

二、SSO服务器搭建后续流程（含cas.zip处理） #

1. 处理cas-initializr生成的cas.zip #

• 解压cas.zip到本地任意目录（如D:\cas-sso-server）
• 进入解压后的目录，执行gradlew clean build完成项目编译，确保无编译错误。

2. 核心配置调整 #

修改src/main/resources/application.properties，配置基础参数：

# CAS服务器基础地址
cas.server.name=http://localhost:8080
cas.server.prefix=http://localhost:8080/cas
# 测试用默认用户（生产环境需替换为真实认证源）
cas.authn.accept.users=casuser::Mellon

3. 重新启动CAS #

执行gradlew bootRun启动服务，成功启动后访问http://localhost:8080/cas，使用casuser/Mellon登录验证是否正常。

4. 接入业务系统（实现SSO） #

以Spring Boot客户端为例：

• 在客户端项目的build.gradle中添加依赖：

  implementation 'org.springframework.boot:spring-boot-starter-security'
  implementation 'org.springframework.security:spring-security-cas'
  

• 配置客户端application.properties：

  server.port=8081
  # CAS服务器地址前缀
  cas.server-url-prefix=http://localhost:8080/cas
  # 客户端回调地址（需在CAS服务器配置允许的服务列表）
  cas.service=http://localhost:8081/login/cas
  

• 配置Spring Security的CAS认证逻辑，实现客户端跳转CAS登录、单点登出功能。

5. 生产环境部署 #

将编译生成的build/libs/cas.war包放入Apache Tomcat的webapps目录，启动Tomcat后访问http://localhost:8080/cas（若Tomcat端口修改，需同步调整CAS配置中的地址）。

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