Debian系统中如何排查Tomcat故障

日志是定位Tomcat故障的核心线索，需优先检查。Debian下Tomcat日志通常位于/var/log/tomcatX/目录（X为版本号，如tomcat9），关键文件包括：

catalina.out：记录启动、运行及关闭过程的详细日志，包含错误堆栈信息；
localhost.log：记录应用部署、Servlet初始化等应用层日志；
localhost_access_log.*.txt：记录HTTP请求访问日志（如状态码、请求路径）。
使用以下命令实时查看日志（以catalina.out为例）：

tail -f /var/log/tomcatX/catalina.out

若日志未生成或权限不足，可检查logs目录权限（需tomcat用户可写）或logging.properties配置。

确认Tomcat是否正在运行，使用以下命令：

ps aux | grep tomcat

若无org.apache.catalina.startup.Bootstrap进程（Tomcat主进程），说明未启动或异常终止。此时可尝试重启服务：

sudo systemctl restart tomcat

若重启失败，需结合日志进一步分析。

Tomcat默认使用8080（HTTP）、8005（Shutdown）、**8009（AJP）**端口，若被其他进程占用，会导致启动失败。使用以下命令检查端口占用：

sudo netstat -tulnp | grep ':8080\b'  # 精确匹配8080端口
# 或
sudo lsof -i :8080

若端口被占用（如PID=1234的nginx进程），可选择：

终止占用进程：sudo kill -9 1234；
修改Tomcat端口：编辑/etc/tomcatX/conf/server.xml，找到<Connector>标签，修改port属性（如改为9080）。

Tomcat的核心配置文件server.xml（位于/etc/tomcatX/conf/）若存在语法错误，会导致启动失败。常见错误包括：

xmllint --noout /etc/tomcatX/conf/server.xml

若存在错误，根据提示修正后重启Tomcat。

Tomcat依赖JDK运行，需检查以下内容：

java -version
javac -version

设置JAVA_HOME：编辑/etc/environment或/etc/profile，添加：

export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH

使配置生效：source /etc/environment。

若系统资源不足（如内存、磁盘空间），Tomcat可能无法启动或运行缓慢：

内存不足：表现为java.lang.OutOfMemoryError，需调整JVM内存参数（编辑/etc/tomcatX/bin/catalina.sh），增加-Xms（初始堆）和-Xmx（最大堆）值（如-Xms1024M -Xmx2048M）；
磁盘空间不足：检查根分区空间：df -h /，若使用率超过80%，需清理旧文件（如/var/log/下的旧日志）。

若Tomcat启动正常但无法访问应用，需检查应用部署情况：

应用目录完整性：webapps目录下的应用WAR包或文件夹是否存在（如ROOT.war或myapp文件夹）；
应用日志：查看logs/localhost.log，若有SEVERE级别的部署错误（如Error deploying web application directory），需修复应用配置（如web.xml语法错误）或缺失依赖（如JAR包）；
重新部署：若应用损坏，可删除webapps下的应用目录及work目录（缓存），然后重启Tomcat。

若本地可访问（curl -I http://localhost:8080返回200）但外部无法访问，需检查：

通过以上步骤逐步排查，可定位并解决Debian系统中Tomcat的常见故障。若问题仍未解决，建议查阅Tomcat官方文档或社区论坛（如Stack Overflow）获取更具体的帮助。

最新问答