JeecgBoot单点登录404问题排查与解决方案

问题背景

在使用JeecgBoot框架搭建的单点登录系统中，当用户访问http://localhost:3100/时，系统返回404错误页面。这种情况通常发生在CAS单点登录系统的部署或配置过程中。

环境配置

• JDK版本：1.8
• 数据库：MySQL 8.0
• CAS版本：5.2.6
• 构建工具：Maven 3.6.1
• 应用服务器：Tomcat 9.0.102

可能原因分析

1. 应用未正确部署：Tomcat服务器可能没有成功加载CAS应用
2. 上下文路径配置错误：应用部署的上下文路径与访问路径不匹配
3. CAS服务未启动：CAS核心服务可能没有正常启动
4. 依赖冲突：Maven依赖可能存在版本冲突
5. 配置文件错误：application.properties或application.yml中的配置可能有误

解决方案

1. 检查应用部署状态

首先确认CAS应用是否已成功部署到Tomcat服务器：

1. 查看Tomcat的webapps目录，确认cas.war文件已解压
2. 检查Tomcat日志catalina.out，查看是否有部署错误
3. 确认Tomcat启动过程中没有抛出异常

2. 验证上下文路径

检查应用的上下文路径配置：

1. 查看server.xml中的Context配置
2. 确认war包名称与访问路径匹配
3. 可以尝试访问http://localhost:3100/cas/login验证

3. 检查CAS服务配置

1. 确认application.properties中的配置项：

   • server.port=3100
   • server.context-path=/cas
   • cas.server.name=http://localhost:3100
   • cas.server.prefix=${cas.server.name}/cas

2. 检查数据库连接配置是否正确

4. 依赖管理

1. 执行mvn dependency:tree查看依赖树
2. 检查是否有冲突的依赖版本
3. 确保CAS核心依赖版本为5.2.6

最佳实践建议

1. 日志配置：增加日志级别，便于排查问题

   logging.level.org.apereo.cas=DEBUG
   

2. 健康检查：实现健康检查端点，确认各组件状态

   @RestController
   @RequestMapping("/status")
   public class StatusController {
       @GetMapping
       public String check() {
           return "OK";
       }
   }
   

3. 分阶段部署：先部署基础CAS服务，再集成JeecgBoot

4. 配置校验：编写配置校验工具，确保关键配置项正确

总结

JeecgBoot集成CAS单点登录时出现404错误，通常是由于部署配置不当或服务未正确启动导致。通过系统化的排查步骤，可以从部署状态、上下文路径、服务配置和依赖管理等多个维度定位问题根源。建议开发者在部署过程中保持清晰的日志记录，并采用分阶段验证的方式确保各组件正常工作。