Ubuntu Java日志与应用程序调试技巧

Ubuntu Java日志与应用程序调试技巧

一日志框架与输出配置

明确项目使用的日志框架：Log4j2、Logback、SLF4J、java.util.logging。在 Logback 中可通过设置 root level=“info” 并配置 ConsoleAppender/FileAppender 输出到控制台与滚动文件；在 Log4j2 中使用 RollingFile 配合 SizeBasedTriggeringPolicy 实现按大小滚动；使用 java.util.logging 时以 logging.properties 指定 FileHandler/ConsoleHandler 与 SimpleFormatter。示例（Logback 片段）：

<configuration>
  <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
    <encoder><pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder>
  </appender>
  <root level="info"><appender-ref ref="console"/></root>
</configuration>

示例（Log4j2 片段）：

<Configuration status="WARN">
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
    </Console>
    <RollingFile name="RollingFile" fileName="logs/app.log"
                 filePattern="logs/app-%d{yyyy-MM-dd}-%i.log.gz">
      <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
      <Policies><SizeBasedTriggeringPolicy size="10MB"/></Policies>
      <DefaultRolloverStrategy max="10"/>
    </RollingFile>
  </Appenders>
  <Loggers><Root level="info"><AppenderRef ref="Console"/><AppenderRef ref="RollingFile"/></Root></Loggers>
</Configuration>

示例（JUL 片段）：

handlers=java.util.logging.FileHandler, java.util.logging.ConsoleHandler
java.util.logging.FileHandler.pattern=%h/myapp.log
java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter
.level=ALL

启动时加载配置：java -Djava.util.logging.config.file=logging.properties -jar app.jar。以上做法便于在不同环境快速切换日志级别与输出目的地。

二在 Ubuntu 终端高效查看与分析日志

先确认日志路径（在应用配置如 log4j.properties/logback.xml/application.properties 中定义），再用终端工具观察：
- 查看末尾 50 行：tail -n 50 /path/to/app.log
- 实时跟踪：tail -f /path/to/app.log
- 快速检索错误：grep -n “ERROR” /path/to/app.log 或 grep -C 5 “Exception” /path/to/app.log
将应用接入 systemd 时，可用 journalctl 集中查看：journalctl -u yourapp.service -f。必要时在 systemd unit 中设置 StandardOutput/StandardError 指向文件或 journal。上述方法覆盖“定位日志文件—实时观察—关键字检索”的完整链路。

三 JVM 与 GC 日志的开启与分析

在 JVM 启动参数中开启 GC 详细日志，便于定位停顿与内存问题：
```
-Xms512m -Xmx2048m \
-XX:+PrintGCDetails -XX:+PrintGCTimeStamps \
-Xloggc:/var/log/java/gc.log
```
使用 tail -f /var/log/java/gc.log 实时观察；借助 GCViewer 等工具可视化分析停顿时间与回收效果。合理设置堆大小（如 -Xms/-Xmx）并结合 GC 日志判断是否需要调优年轻代/老年代比例与回收器策略。

四线程与内存问题的快速定位

定位“卡顿/高 CPU/疑似死锁”时，先获取 Java 进程 PID：jps -l；再抓取线程快照：jstack > thread_dump.txt。多次间隔抓取（如每 5–10 秒一次）对比 BLOCKED/WAITING 堆栈，配合关键字（如 “BLOCKED”、““deadlock”**）定位竞争点。
在线监控与诊断可用 VisualVM（CPU、内存、线程、抽样/内存快照），必要时配合 JProfiler/YourKit 深入分析对象生命周期与热点方法。命令行党可用 jstat 观察 GC 行为，用 jmap 生成堆转储并用 MAT 分析泄漏根因。

五远程调试与常见问题处理

远程调试（生产/测试环境常用）：启动时加入
```
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=5005
```
在 IntelliJ IDEA/Eclipse 创建 Remote 配置，连接到 host:5005 即可断点、观察变量与调用栈。
常见问题速解：
- 中文乱码：在启动参数中显式指定 -Dfile.encoding=UTF-8，并在日志框架（如 Log4j）中设置 encoding=UTF-8，确保“JVM—Appender—终端/文件”三者编码一致。
- 日志分散难检索：将应用日志接入 journald 或使用 ELK（Elasticsearch/Logstash/Kibana）/Graylog 统一采集、解析与可视化，便于按时间、级别、traceId 检索与告警。

最新问答

相关标签