JStack 参考文档 #

1. 什么是 JStack？ #

JStack 是 Java Development Kit (JDK) 提供的一个命令行工具，用于生成 Java 虚拟机 (JVM) 中所有线程的转储（Thread Dump）。线程转储包含了每个线程的状态、调用栈、锁信息等，是分析 Java 应用程序性能问题、死锁、线程阻塞等问题的重要工具。

2. JStack 基本语法 #

bash 
jstack [选项] <进程ID>

3. 常用选项 #

选项 描述
-F 强制生成线程转储，当正常方式无法获取时使用
-l 长格式输出，包含锁的详细信息
-m 混合模式输出，包含 Java 栈和本地 (native) 栈信息
-h 显示帮助信息
-help 显示帮助信息

4. 使用示例 #

4.1 基本使用 #

首先，使用 jps 命令获取 Java 进程的 ID：

bash 
jps

输出示例：

text 
12345 MyApp
67890 Jps

然后，使用 JStack 生成线程转储：

bash 
jstack 12345

4.2 保存线程转储到文件 #

bash 
jstack 12345 > thread_dump.txt

4.3 包含锁信息 #

bash 
jstack -l 12345 > thread_dump_with_locks.txt

4.4 混合模式输出 #

bash 
jstack -m 12345 > thread_dump_mixed.txt

4.5 强制生成线程转储 #

当 JVM 无响应时使用：

bash 
jstack -F 12345 > thread_dump_force.txt

5. 分析线程转储 #

5.1 线程状态 #

线程转储中常见的线程状态包括：

  • RUNNABLE：线程正在运行或就绪
  • BLOCKED：线程被阻塞，等待获取锁
  • WAITING：线程等待其他线程的通知
  • TIMED_WAITING：线程在指定时间内等待其他线程的通知
  • TERMINATED：线程已终止

5.2 死锁分析 #

JStack 会自动检测并标记死锁。在死锁情况下，线程转储末尾会包含类似以下的信息：

text 
Found one Java-level deadlock:
=============================

"Thread-1":
  waiting to lock monitor 0x00007f8b9c0030c8 (object 0x000000076ae03f58, a java.lang.Object),
  which is held by "Thread-0"
"Thread-0":
  waiting to lock monitor 0x00007f8b9c003318 (object 0x000000076ae03f68, a java.lang.Object),
  which is held by "Thread-1"

Java stack information for the threads listed above:
==================================================
"Thread-1":
        at com.example.DeadlockExample$2.run(DeadlockExample.java:25)
        - waiting to lock <0x000000076ae03f58> (a java.lang.Object)
        - locked <0x000000076ae03f68> (a java.lang.Object)
"Thread-0":
        at com.example.DeadlockExample$1.run(DeadlockExample.java:15)
        - waiting to lock <0x000000076ae03f68> (a java.lang.Object)
        - locked <0x000000076ae03f58> (a java.lang.Object)

Found 1 deadlock.

5.3 常见性能问题分析 #

  1. 线程阻塞：查找状态为 BLOCKED 的线程，分析它们等待的锁。
  2. 长时间运行的线程：查找状态为 RUNNABLE 且调用栈深度较大的线程。
  3. 线程泄漏：检查是否有大量相同类型的线程。
  4. 锁竞争：分析锁的持有和等待情况。

6. 高级用法 #

6.1 定期生成线程转储 #

使用脚本定期生成线程转储，以便分析性能变化：

bash 
#!/bin/bash
PID=12345
for i in {1..5}
do
    timestamp=$(date +%Y%m%d_%H%M%S)
    jstack -l $PID > thread_dump_${timestamp}.txt
    sleep 5
done

6.2 结合其他工具分析 #

  • JConsole：可视化监控 JVM 状态
  • VisualVM：提供更详细的线程分析功能
  • MAT (Memory Analyzer Tool)：分析内存泄漏和线程问题
  • JProfiler：商业性能分析工具

7. 注意事项 #

  1. JStack 必须与目标 Java 进程使用相同版本的 JDK。
  2. 在生产环境使用时，生成线程转储可能会对应用程序性能产生短暂影响。
  3. 对于大型应用程序，线程转储文件可能会很大，需要合理管理。
  4. 分析线程转储需要一定的经验，建议结合多个时间点的转储进行比较分析。

8. 常见问题与解决方案 #

8.1 无法连接到目标进程 #

问题：

text 
jstack: Unable to open socket file: target process not responding or HotSpot VM not loaded

解决方案：

  • 确保进程 ID 正确
  • 确保使用相同版本的 JDK
  • 尝试使用 -F 选项强制生成

8.2 权限问题 #

问题：

text 
jstack: Permission denied

解决方案：

  • 使用与目标进程相同的用户身份运行 JStack
  • 在 Linux 系统上，可以使用 sudo 命令

8.3 线程转储不完整 #

问题：生成的线程转储缺少某些线程信息。

解决方案：

  • 尝试使用 -F 选项
  • 确保目标进程处于稳定状态
  • 多次生成线程转储进行比较

9. 总结 #

JStack 是 Java 开发和运维中不可或缺的工具，通过生成和分析线程转储，可以快速定位和解决 Java 应用程序的性能问题、死锁、线程阻塞等问题。掌握 JStack 的使用方法，对于提高 Java 应用程序的稳定性和性能至关重要。

10. 参考资料 #

最后更新：2026-02-05