Ubuntu Tomcat故障排查步骤

Ubuntu Tomcat故障排查步骤

一 快速判定与日志定位

• 确认运行状态与日志路径
  • 查看进程：ps -ef | grep tomcat
  • 查看监听端口：ss -ltnp | grep 8080 或 lsof -i:8080
  • 查看日志：
    • 系统包安装：/var/log/tomcat9/catalina.out
    • 手动解压安装：$CATALINA_HOME/logs/catalina.out
  • 实时跟踪：tail -f catalina.out；关键字过滤：grep -i “ERROR|SEVERE” catalina.out
  • 访问日志与事件日志位于同一 logs 目录，可辅助判断部署与访问链路。

二 常见故障与处理清单

• 端口被占用
  • 定位进程：lsof -i:8080 或 netstat -anp | grep 8080
  • 处理：释放端口或调整 server.xml 的 Connector port。
• Java 环境问题
  • 检查：java -version、which java
  • 处理：安装匹配版本的 JDK，并正确设置 JAVA_HOME/JRE_HOME（系统服务与手动启动的环境可能不同）。
• 版本不匹配
  • 处理：确认 Tomcat 与 JDK 版本兼容（如 JDK 8 对应较新的 Tomcat 9）。
• 配置错误
  • 重点检查：conf/server.xml、web.xml、context.xml 等是否存在语法或路径错误。
• 权限问题
  • 现象：部署/解压失败、文件无法写入。
  • 处理：核对 $CATALINA_HOME、webapps、logs 等目录属主与权限，避免使用危险的 777。
• 资源不足
  • 检查：free -m、df -h、top；必要时扩容或优化应用。
• 安装包错误
  • 现象：启动报 ClassNotFound: org.apache.catalina.startup.Bootstrap。
  • 处理：下载并使用 Binary Distributions 而非 Source Code 包。

三 无法访问页面的网络排查

• 本机可达性：在服务器上 curl http://localhost:8080 验证服务是否正常响应。
• 远程连通性：ping 服务器IP；必要时测试其它端口/协议。
• 防火墙与安全组：
  • Ubuntu 本地：sudo ufw status，按需 sudo ufw allow 8080/tcp
  • 云主机：开放安全组 8080/TCP 入方向。
• 监听地址：确认 server.xml 中 Connector 的 address 与 scheme（如需对外访问，避免仅绑定 127.0.0.1）。
• 浏览器与缓存：更换浏览器/隐私模式，或 curl -v 查看 HTTP 细节。

四 日志与配置的深度检查

• 日志级别与输出
  • 调整 conf/logging.properties（如将某些包提升到 FINE/DEBUG），或设置 JVM 参数：-Djava.util.logging.ConsoleHandler.level=FINE。
  • 实时排查：tail -f catalina.out | grep -i error。
• 访问与事件日志
  • 访问日志可确认请求是否到达、返回码（如 200/404/500），事件日志用于核对启动/部署事件。
• 配置文件语法
  • 重点核对 server.xml 的端口、协议、线程池、连接器与 Host/Context 配置；变更前先备份。
• JVM 与内存
  • 在 setenv.sh（若不存在可创建）中设置：JAVA_OPTS=“-Xms512m -Xmx1024m”，缓解 OutOfMemoryError。

五 一键排查命令清单

• 查看状态与端口
  • ps -ef | grep tomcat
  • ss -ltnp | grep 8080 或 lsof -i:8080
• 查看日志
  • tail -n50 -f /var/log/tomcat9/catalina.out（系统包）
  • tail -n50 -f $CATALINA_HOME/logs/catalina.out（手动安装）
  • grep -i “ERROR|SEVERE” $CATALINA_HOME/logs/catalina.out
• Java 与网络
  • java -version && which java
  • curl -v http://localhost:8080
  • ping 服务器IP
  • sudo ufw status 与（如需）sudo ufw allow 8080/tcp
• 资源与权限
  • free -m && df -h && top
  • 核对目录权限（如 webapps/ logs/）与属主，避免使用 777。