CentOS 上部署与运行 JSP 项目的常见问题与排查清单
一 环境安装与版本匹配
- 安装基础运行环境：在 CentOS 7/8 上优先安装 OpenJDK 8，并验证版本；如使用 Tomcat 官方二进制包，建议选择 Tomcat 8.5.x/9.0.x 的稳定版本，避免过旧版本带来的兼容性与安全问题。部署时将应用打包为 WAR 放入 webapps，Tomcat 会自动解压部署。
- 版本兼容要点：曾出现 JDK 1.8 与 Tomcat 7.0.25 不兼容导致 JSP 无法编译的问题，升级到 Tomcat 8.0.11 后恢复；因此遇到编译类问题时优先核对 JDK 与 Tomcat 的匹配矩阵。
- 环境变量与目录：设置 JAVA_HOME（指向 JDK 安装目录），如使用官方解压版 Tomcat，可设置 CATALINA_HOME 并将 bin 加入 PATH，便于使用 startup.sh/shutdown.sh 与 systemd 管理。
二 启动与访问故障排查
- 端口占用：Tomcat 默认 8080，若端口被占用可在 conf/server.xml 的 调整端口；排查命令可用 ss -tlnp | grep 8080 或 lsof -iTCP:8080。
- 防火墙放行：CentOS 7 使用 firewalld，常用命令为：firewall-cmd --permanent --add-port=8080/tcp && firewall-cmd --reload；如需外部访问管理端口（如 8005），一并放行。
- 服务管理：使用 systemd 管理 Tomcat（推荐）：systemctl start|stop|restart|status tomcat；若通过官方 RPM 安装可直接启用开机自启，解压版可自建服务单元或使用脚本管理。
三 编译与类加载错误
- JSP 无法编译类：典型异常为 ClassNotFoundException: org.apache.jsp.xxx_jsp，多由 work/Catalina/localhost/ 目录不可写或属主不一致导致 JSP 生成的 Servlet 类无法写入；清理并修复权限：停止 Tomcat，删除 work/Catalina/localhost/ 下对应应用目录，确保运行 Tomcat 的用户对该目录具备写权限（如 chown/chmod），再重启。
- 无法编译类：出现 Unable to compile class for JSP 时，优先检查 JDK 安装与版本匹配、JSP 语法与依赖；若曾用 root 启动过 Tomcat，后又用普通用户启动，残留的 work 目录属主会导致后续写入失败，务必统一运行用户并清理 work 目录。
- 导入类不可用：如 Only a type can be imported、<%@ page import=“…”> 失败，常见于打包遗漏（未将依赖打进 WEB-INF/lib）、服务器缺少驱动（如数据库 JDBC 包）、或 JDK/Tomcat 版本不一致；核对依赖、补齐驱动、统一版本后重试。
四 文件权限与运行用户
- 统一运行用户：建议创建专用用户（如 tomcat）运行 Tomcat，避免 root 直接运行；涉及目录（如 webapps、logs、work、temp）统一属主与权限，减少跨用户访问问题。
- 生成文件权限：应用运行生成的文件/目录权限由 umask 与父目录权限共同决定；可在 catalina.sh 中设置 UMASK=022（或所需掩码），或在部署脚本中统一 chown/chmod；对需要共享的目录可使用 ACL 精细化授权（如 setfacl -Rdm “u::rwx,g::rwx,o::rx” upload/）。
五 日志与运维最佳实践
- 应用日志：在项目中集成 Log4j/Logback，将日志输出到 /var/log/yourapp/，并按日滚动；示例 RollingFileAppender 可配置 MaxFileSize、MaxBackupIndex 控制体积与保留份数。
- 系统日志轮转：使用 logrotate 管理应用与 Tomcat 日志，示例配置：/var/log/yourapp/*.log { daily; rotate 30; compress; missingok; notifempty; create 0644 tomcat tomcat }。
- 集中化与告警：上线后可接入 ELK/Graylog 做检索、可视化与告警；同时做好日志脱敏、访问控制与定期备份，避免磁盘被占满或敏感信息外泄。
