Linux系统Tomcat启动失败怎么办 - 问答

Linux 下 Tomcat 启动失败的快速排查与修复

一、先确认是否真的在运行

查看进程：ps -aux | grep tomcat；若使用 systemd 管理，执行：systemctl status tomcat。正常应看到包含 org.apache.catalina.startup.Bootstrap 的 Java 进程。
查看监听端口：ss -tunlp | grep java 或 netstat -tunlp | grep java；默认 HTTP 端口为 8080。
本地连通性测试：curl -I http://localhost:8080，预期返回 HTTP/1.1 200 或 302。
若进程不存在或无监听，基本可判定启动失败，进入日志定位。

二、查看日志定位根因

进入日志目录：cd $CATALINA_HOME/logs（若未设置 CATALINA_HOME，通常在 Tomcat 安装目录的 logs 下）。
关键日志与用途：
- catalina.out：主日志，绝大多数启动错误都会在这里打印。
- catalina.log：启动过程与组件初始化日志。
- localhost.log：应用部署与上下文初始化日志。
- localhost_access_log.*.txt：访问日志（用于排查访问层面问题）。
典型错误关键词：
- Address already in use（端口被占用）
- ClassNotFound/NoClassDefFoundError（依赖或 JDK 问题）
- SEVERE [main] org.apache.catalina.startup.HostConfig.deployDirectory（应用部署失败）
- OutOfMemoryError（内存不足）

三、常见原因与对应修复

端口被占用（如 8080/8005）
- 查找占用：lsof -i:8080 或 ss -tunlp | grep 8080；必要时 kill -9 释放端口。
- 或修改 $CATALINA_HOME/conf/server.xml 中的为未占用端口。
Java 环境或版本不匹配
- 验证：java -version、javac -version；确保 JAVA_HOME 指向 JDK（而非仅 JRE），且版本与 Tomcat 兼容。
- 服务以 no_login 方式启动时，需在用户环境文件显式导出变量（Ubuntu：~/.bashrc、~/.profile；CentOS：~/.bashrc、~/.bash_profile）：
  - export JAVA_HOME=/usr/local/jdk/jdk1.8.0_151
  - export CLASSPATH=$JAVA_HOME/lib:$JAVA_HOME/jre/lib
  - export PATH=$JAVA_HOME/bin:$PATH
配置文件错误
- 重点检查 $CATALINA_HOME/conf/server.xml 的配置、目录权限与应用的 docBase 是否存在且可读。
内存不足
- 在 bin/catalina.sh 中设置：export JAVA_OPTS=“-Xms512m -Xmx1024m -XX:MaxMetaspaceSize=256m”（按机器资源调整）。
应用部署失败
- 查看 localhost.log 与应用日志；校验 WAR 包完整性与依赖，必要时清理 webapps 后重部署。
磁盘空间不足
- 执行 df -h 检查；若日志目录过大，可清理旧日志后再启动。
权限问题
- 确保运行用户对 $CATALINA_HOME（含子目录与 logs）具备读写执行权限。

四、网络与防火墙检查

确认监听端口已绑定到 0.0.0.0（而非仅 127.0.0.1）：ss -tunlp | grep java。
防火墙放行（firewalld 示例）：
- firewall-cmd --permanent --add-port=8080/tcp
- firewall-cmd --reload
SELinux（RHEL/CentOS）：
- 临时测试：setenforce 0
- 永久调整（谨慎）：sed -i ‘s/SELINUX=enforcing/SELINUX=permissive/g’ /etc/selinux/config
外部连通性：从外部机器执行 curl -I http://<服务器IP>:8080 验证。

五、服务管理与一键自检脚本

常用服务管理：
- 启动/停止/重启：systemctl start|stop|restart tomcat
- 查看状态：systemctl status tomcat
一键自检脚本（示例，保存为 check_tomcat.sh，chmod +x 后执行）：
- 作用：快速检查进程、端口、日志错误、JDK、磁盘。
- 用法：./check_tomcat.sh [/opt/tomcat]（参数为 CATALINA_HOME，默认当前目录）

#!/usr/bin/env bash
CATALINA_HOME="${1:-.}"
LOGS="$CATALINA_HOME/logs"
PORT=8080

echo "=== Tomcat 快速自检 ==="
echo "[1/6] Java 版本与 JAVA_HOME"
java -version 2>&1 || { echo "未找到 java，请安装 JDK 并配置 JAVA_HOME"; exit 1; }
echo "JAVA_HOME=$JAVA_HOME"

echo "[2/6] 进程与端口"
ps -ef | grep -i tomcat | grep -v grep || echo "未检测到 Tomcat 进程"
ss -tunlp | grep ":$PORT" || echo "端口 $PORT 未被监听"

echo "[3/6] 最近启动日志错误（catalina.out）"
[ -f "$LOGS/catalina.out" ] && tail -n 50 "$LOGS/catalina.out" | grep -i -E "error|exception|fail|SEVERE" || echo "未找到 $LOGS/catalina.out"

echo "[4/6] 应用部署日志（localhost.log）"
[ -f "$LOGS/localhost.log" ] && tail -n 30 "$LOGS/localhost.log" || echo "未找到 $LOGS/localhost.log"

echo "[5/6] 磁盘空间"
df -h | grep -E 'Filesystem|/$'

echo "[6/6] 监听地址"
ss -tunlp | grep java
echo "自检完成，请结合上述输出定位问题。"

以上步骤覆盖了 90%+ 的启动失败场景：先看日志找关键词，再按“端口 → Java → 配置 → 应用 → 资源/权限 → 网络”的顺序逐项排除，通常可以快速恢复。

0 赞

0 踩