温馨提示×

ubuntu tomcat日志如何定位错

小樊
47
2026-09-03 12:07:07
栏目: 智能运维

在 Ubuntu 上用 Tomcat 时,定位错误一般遵循**“先看哪类日志 → 再按关键字查 → 结合应用日志”**的思路。下面按实战方式说明。


一、Tomcat 常见日志位置(Ubuntu)

Tomcat 日志通常在:

/var/log/tomcat9/        # Ubuntu 默认(版本可能不同)

或你自定义的安装目录:

$TOMCAT_HOME/logs/

常见日志文件:

文件 作用
catalina.out 最重要,标准输出 + 错误
catalina.yyyy-mm-dd.log 每日 Catalina 日志
localhost.yyyy-mm-dd.log 应用级异常
localhost_access_log.yyyy-mm-dd.txt 访问日志
manager / host-manager 管理端日志

二、最常见排错步骤

1️⃣ 看 catalina.out(首选)

tail -n 200 /var/log/tomcat9/catalina.out

实时查看:

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

重点看:

  • Exception
  • Caused by
  • SEVERE
  • ERROR

2️⃣ 按关键字搜索错误

grep -n "Exception" /var/log/tomcat9/catalina.out

只看最近错误:

grep -A 20 "ERROR" /var/log/tomcat9/catalina.out | tail -50

3️⃣ 看 localhost 日志(应用报错)

tail -n 100 /var/log/tomcat9/localhost.2026-01-21.log

适合:

  • Spring / Servlet 初始化失败
  • 404 / 500 内部异常

4️⃣ 看访问日志(请求层面)

cat /var/log/tomcat9/localhost_access_log.2026-01-21.txt | grep 500

可定位:

  • 哪个 URL 报错
  • 状态码(404 / 500 / 502)

三、常见错误 & 快速定位

❌ Tomcat 启动失败

看:

catalina.out

常见原因:

  • 端口被占用(8080)
  • JAVA_HOME 错误
  • web.xml 配置错误

❌ 应用 404

检查:

  • WAR 是否部署成功
  • 应用上下文路径
ls /var/lib/tomcat9/webapps/

❌ OutOfMemoryError

grep -i "OutOfMemory" catalina.out

解决:

  • 调整 JAVA_OPTS
/etc/default/tomcat9

❌ ClassNotFoundException

说明:

  • 包没打进 WAR
  • lib 缺失

四、结合应用自身日志(非常重要)

如果项目用了:

  • logback
  • log4j2

日志通常在:

/var/log/yourapp/

或:

tomcat/webapps/yourapp/WEB-INF/logs/

五、排错黄金流程(记住这个)

catalina.out → 找 Exception
        ↓
localhost.log → 应用异常
        ↓
access log → 请求是否到达
        ↓
应用业务日志 → 具体逻辑错误

如果你愿意,可以把具体报错内容或日志片段贴出来,我可以直接帮你定位是哪一类问题(Spring、JVM、配置、权限等)。

0