如何排查Linux上Tomcat的错误日志

Linux上Tomcat错误日志排查步骤

一 定位日志目录与核心文件

• 常见日志根目录为：$CATALINA_HOME/logs（Tomcat安装目录下的 logs），部分发行版或安装方式会放在：/var/log/tomcat 或 /var/log/tomcatX（X为版本号，如 tomcat9）。
• 关键文件与作用：
  • catalina.out：标准输出与错误输出（启动、运行期全部打印）。
  • localhost..log：与本地主机相关的应用事件与异常。
  • localhost_access_log..txt：访问日志（HTTP 请求记录）。
  • manager..log / host-manager..log：管理应用的日志。
• 快速定位命令示例：
  • 查看进程与安装路径：ps -ef | grep tomcat；readlink -f $(which catalina.sh)
  • 进入日志目录：cd $CATALINA_HOME/logs 或 ls /var/log/tomcat*
• 若不确定访问日志位置，可在 server.xml 的 AccessLogValve 中查看 directory/prefix 配置。

二 快速检索与过滤日志

• 实时查看最新输出：tail -f $CATALINA_HOME/logs/catalina.out
• 过滤关键字（ERROR/WARN/Exception）：grep -i “ERROR|WARN|Exception” $CATALINA_HOME/logs/catalina.out
• 实时过滤：tail -f $CATALINA_HOME/logs/catalina.out | grep --line-buffered “ERROR”
• 分页与检索：less $CATALINA_HOME/logs/catalina.out（进入后 /ERROR 搜索，n/N 跳转）
• 按时间段查看（示例时间段）：sed -n ‘/2025-11-21 10:00:00/,/2025-11-21 10:10:00/p’ $CATALINA_HOME/logs/catalina.out
• 统计错误数量：awk ‘/ERROR/ {count++} END {print “ERROR count:”, count}’ $CATALINA_HOME/logs/catalina.out
• 若使用 systemd 管理 Tomcat，可结合系统日志：journalctl -u tomcat.service -f

三 从日志中提取有效线索

• 优先关注级别为 ERROR/WARN 的条目，并读取其 时间戳 以还原故障现场。
• 阅读 异常类型 与 错误消息（如：java.lang.NullPointerException、java.sql.SQLException），定位到具体类与模块。
• 分析 堆栈跟踪（stack trace）：从最底部“Caused by”向上追溯，找到应用代码或第三方库的首个调用帧。
• 若日志含中文乱码，可在 server.xml 的 Connector 增加 URIEncoding=“UTF-8”，并在启动脚本中设置 -Dfile.encoding=UTF-8。

四 常见故障与对应日志线索

• 端口被占用：catalina.out 出现 “Address already in use”。处理：ss -lntp | grep 8080 或 netstat -tlnp | grep 8080 找到占用进程并释放端口。
• 内存不足：日志出现 OutOfMemoryError。处理：检查堆设置（-Xms/-Xmx）、分析对象泄漏、考虑增大内存或优化代码。
• 启动或部署失败：查看 localhost..log 与 catalina.out 中的配置解析错误、类加载失败（ClassNotFoundException/NoClassDefFoundError）、部署描述符错误等。
• 访问异常（4xx/5xx）：查看 localhost_access_log..txt 的返回码、URL、耗时，定位是应用逻辑还是后端依赖问题。
• 响应变慢或无响应：除日志外，抓取 线程转储 分析阻塞与死锁：jstack <TOMCAT_PID> > threaddump.txt（必要时多次间隔抓取）。

五 进阶 日志级别与长期治理

• 调整日志级别：编辑 conf/logging.properties，常见级别为 SEVERE、WARNING、INFO、CONFIG、FINE、FINER、FINEST，针对特定包提升日志细粒度以便排查（如：java.util.logging.ConsoleHandler.level = FINE）。
• 日志轮转与归档：使用 cronolog 或系统 logrotate 按日期切分 catalina.out，避免单文件过大；保留策略建议至少 7–30 天。
• 集中化与可视化：将 Tomcat 日志接入 ELK（Elasticsearch/Logstash/Kibana） 或 Graylog，便于检索、告警与容量规划。