Ubuntu Java日志错误排查步骤

遇到Ja va日志错误，别慌。先从根部摸起，一步一步往外排。

一、快速定位与日志收集

先说环境。Ja va装没装到位？版本对不对？两个命令一测就知：ja va -version 和 ja vac -version。要是没装，先装 default-jdk。

接下来，找到进程。PID是多少？用 ps -ef | grep ja va 或者 jps 扫一下。

再说实时监控。如果应用由服务托管，优先到它自己的日志文件里翻；要是直接跑在终端，或者输出被重定向了，那就盯住标准输出和错误输出——用 tail -f /proc//fd/1 和 tail -f /proc//fd/2 两个命令，实时看结果。

系统侧也别忽略。翻翻 /var/log/syslog，用 tail -n 100 扫一眼，重点看内核、OOM（内存溢出）或者系统服务有没有对Ja va进程下黑手。

如果是Web应用，比如Tomcat，那得把 catalina.out 和应用日志目录都翻个底朝天，盯着异常堆栈和启动失败信息。

二、应用日志框架与输出配置

每个项目都有自己的日志框架，Log4j2、Logback、ja va.util.logging，各有各的脾气。先搞清楚你家项目用的是哪一套，配置文件在哪，日志级别怎么设。

如果问题一时半会儿露不出来，可以把根日志级别临时调到DEBUG。这样能捕获更多细节，等定位到原因再降回去。别一直开着DEBUG，日志量太大，磁盘受不了。

顺便检查一下，日志有没有写入文件？有没有配置按大小或时间滚动？没有滚动策略，日志文件会越来越大，最后撑满磁盘，应用也得歇菜。

举个Logback的配置例子，简单明了：

    
        
            %d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n
        
    
    
        
    

再看Log4j2的滚动文件配置：

小规模排查时，用 grep、awk、sed 配合关键字就能搞定。中大型项目，建议直接上ELK Stack（Elasticsearch、Logstash、Kibana）或者Graylog，集中检索和可视化，效率翻倍。

三、运行期诊断与线程内存分析

线程堆栈是定位死锁、阻塞和高占用线程的利器。用 jstack 抓快照，必要的时候多抓几次，对比着看，问题更清楚。

GC监控也不能少。用 jstat -gcutil 1000，每秒输出一次GC情况。如果Full GC频繁出现，那堆内存肯定有问题，得结合堆分析来解。

堆内存分析，关键在启动时加两个参数：-XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/path/to/dump。一旦发生OutOfMemoryError，自动生成Heap Dump文件。然后用Eclipse MAT打开，分析泄漏点和大对象。

别忘了联动系统日志。配合 top/htop、free -m、df -h 和 /var/log/syslog，检查CPU、内存、磁盘的使用情况，排除外部资源瓶颈或OOM-killer的干扰。

四、常见错误场景与修复建议

内存不足或泄漏：表现为OutOfMemoryError、频繁Full GC，应用变慢然后崩溃。关键点在于合理设置 -Xms 和 -Xmx，启动Heap Dump后用MAT定位泄漏点，优化缓存、集合使用和对象生命周期。

未捕获异常导致退出：应用没有顶层异常处理器，未捕获的异常直接让进程退出。解决方案是在关键入口加全局异常日志，并确保日志框架已经正确初始化。

日志文件过大或磁盘写满：没有滚动策略，日志文件越写越大，最终磁盘满了，写入失败甚至系统异常。启用按大小或时间滚动，限制保留个数，同时用 df -h 监控日志目录的使用率。

依赖或类路径问题：ClassNotFoundException 或 NoClassDefFoundError 频繁出现。核对classpath和依赖包是否完整，最好用Ma ven或Gradle管理依赖，发布前校验包内容。

Ja va版本不兼容：运行期出现 UnsupportedClassVersionError 或行为异常。开发环境和运行环境版本要统一，必要时切换 JA VA_HOME 和系统默认的 ja va。

五、高效排查命令清单

• 环境确认：ja va -version、ja vac -version
• 进程定位：ps -ef | grep ja va、jps
• 实时输出：tail -f /proc//fd/1、tail -f /proc//fd/2
• 系统日志：tail -n 100 /var/log/syslog
• 线程与GC：jstack 、jstat -gcutil 1000
• 资源监控：top/htop、free -m、df -h
• 堆分析：启动时加 -XX:+HeapDumpOnOutOfMemoryError -XX:HeapDumpPath=/path，再用Eclipse MAT分析