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

问题背景

在使用JeecgBoot框架搭建的单点登录系统中，用户访问http://localhost:3100/时出现了404错误页面。这种情况通常表明服务器无法找到请求的资源，可能是由于配置错误或部署问题导致的。

环境信息

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

可能原因分析

1. 应用未正确部署：Tomcat服务器可能没有成功加载JeecgBoot应用
2. 上下文路径配置错误：应用部署的上下文路径可能与预期不符
3. 端口冲突：3100端口可能被其他应用占用
4. CAS服务未启动：单点登录依赖的CAS服务可能未正常运行
5. 资源文件缺失：部署包可能不完整，缺少必要的静态资源

排查步骤

1. 检查Tomcat部署状态

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

• 查看Tomcat的webapps目录，确认是否存在对应的应用目录
• 检查Tomcat的logs/catalina.out日志文件，查看应用启动时是否有错误

2. 验证端口监听情况

使用以下命令检查3100端口是否被正确监听：

netstat -ano | findstr 3100

如果端口未被监听，可能是应用未启动或配置了错误的端口。

3. 检查CAS服务状态

单点登录功能依赖于CAS服务，需要确认：

• CAS服务是否已独立部署并正常运行
• CAS服务的版本是否与JeecgBoot兼容
• CAS与JeecgBoot之间的通信配置是否正确

4. 验证上下文路径

检查server.xml或应用的部署配置，确认上下文路径是否正确设置。默认情况下，JeecgBoot可能使用根路径("/")或特定的应用名称作为上下文路径。

解决方案

方案一：重新部署应用

1. 清理Tomcat的webapps目录和工作目录
2. 重新构建应用包并部署
3. 重启Tomcat服务

方案二：调整上下文路径

1. 修改应用的application.properties或application.yml文件
2. 添加或修改server.servlet.context-path配置
3. 例如：server.servlet.context-path=/jeecg-boot

方案三：检查CAS集成配置

1. 确认application.properties中的CAS相关配置
2. 检查cas.server.url、cas.service等关键配置项
3. 确保CAS服务端和客户端的版本兼容

预防措施

1. 标准化部署流程：建立规范的部署检查清单
2. 日志监控：配置完善的日志记录和监控系统
3. 环境验证：在部署前验证所有依赖服务的可用性
4. 文档记录：维护详细的部署文档和配置说明

总结

JeecgBoot单点登录出现404错误通常是由于部署或配置问题导致的。通过系统化的排查方法，可以快速定位问题根源。建议开发团队在部署过程中严格遵循标准流程，并建立完善的监控机制，以确保系统的稳定运行。