CentOS 上 Tomcat 启动失败的常见原因与排查路径
一 常见根因概览
- 端口被占用：默认 8080/8005/8009 被其他进程占用，Tomcat 无法绑定端口。
- Java 环境问题：未安装 JDK、环境变量 JAVA_HOME/JRE_HOME 未设置或设置错误、使用了与 Tomcat 不兼容的 JDK 版本。
- 磁盘空间不足：日志或缓存占满磁盘，导致无法创建/写入文件（如 catalina.out）。
- 权限与路径问题：启动脚本或工作目录权限不足；通过脚本/服务启动时使用了错误的绝对路径。
- 配置错误：server.xml 中 Connector/Host 配置错误、应用 WAR 包损坏或 docBase 目录不存在/不可读。
- 防火墙或 SELinux 拦截：未放行 8080 等端口，或 SELinux 策略阻止绑定/访问。
- 内存不足：JVM 堆/元空间不足，抛出 OutOfMemoryError 导致启动中止。
- 远程/后台启动方式不当：使用 nohup、systemd、远程执行脚本时环境变量缺失或工作目录不正确，进程看似“启动”实则未初始化完成。
二 快速排查步骤
- 确认是否真正启动
- 查看进程：ps -aux | grep tomcat
- 若用 systemd 管理：systemctl status tomcat
- 预期：存在包含 org.apache.catalina.startup.Bootstrap 的 Java 进程；若没有，多半启动失败需看日志。
- 查看启动日志定位根因
- 主日志：tail -f $CATALINA_HOME/logs/catalina.out
- 应用部署日志：tail -f $CATALINA_HOME/logs/localhost.log
- 常见线索：端口冲突（BindException）、JDK 未找到、配置/部署异常堆栈。
- 检查端口占用与配置
- 查占用：ss -tunlp | grep :8080 或 lsof -i:8080
- 处理：结束冲突进程或修改 conf/server.xml 的 Connector 端口。
- 验证监听：启动后应能 ss -tunlp | grep java 看到 Java 进程监听对应端口。
- 校验 Java 环境
- 版本与路径：java -version、which java
- 兼容性：确认 JDK 版本与所用 Tomcat 版本匹配；必要时设置 JAVA_HOME/JRE_HOME。
- 检查磁盘与权限
- 磁盘：df -h、进入 logs 目录执行 du -sh . 清理过大旧日志。
- 权限：确保运行用户对 $CATALINA_HOME、logs、work、temp 具备读写执行权限。
- 网络与安全策略
- 防火墙放行：firewall-cmd --permanent --add-port=8080/tcp && firewall-cmd --reload
- SELinux：排查/临时测试可用 setenforce 0（生产环境谨慎调整策略）。
三 典型错误与修复要点
- 端口冲突：日志出现 Address already in use；用 ss/lsof 找到 PID，kill -9 或修改 server.xml 端口后重启。
- JDK 未就绪：出现 Neither the JAVA_HOME nor the JRE_HOME environment variable is defined；安装 JDK 并正确设置 JAVA_HOME/JRE_HOME。
- 版本不匹配：Tomcat 版本与 JDK 不兼容导致初始化失败；更换为兼容版本。
- 磁盘满：无法写入 catalina.out 或部署失败；清理 logs/ 等目录大文件后重试。
- 配置/应用错误：server.xml 配置错误、WAR 损坏、docBase 不存在；修正配置、重新部署有效包。
- 内存不足：出现 OutOfMemoryError；在 catalina.sh 中设置 JAVA_OPTS（如 -Xms512m -Xmx1024m -XX:MaxMetaspaceSize=256m）。
- 远程/后台启动无效：nohup、systemd、远程脚本执行时环境变量缺失或工作目录错误；改用绝对路径、加载环境脚本、前台试运行确认无错再托管为服务。
四 预防建议
- 使用 systemd 托管 Tomcat，编写服务单元时显式声明 Environment=JAVA_HOME=… 与 WorkingDirectory=…，避免环境缺失。
- 将 JDK 与 Tomcat 版本匹配写入部署文档，统一通过版本管理。
- 建立 日志轮转（如 logrotate）与磁盘阈值告警，避免日志撑满磁盘。
- 变更 server.xml 或应用包前先在测试环境验证，再上线。
- 对外端口统一走 firewalld 放行策略，变更留痕并定期审计。