jstack 是 jdk 自带的线程堆栈分析工具，用于排查死锁、线程阻塞和 cpu 占用高等问题；它能打印指定 java 进程所有线程的调用栈，并自动检测死锁，明确标出“found one java-level deadlock”及相互等待的线程与锁。

jstack 是 JDK 自带的线程堆栈分析工具，常用于排查死锁、线程阻塞、CPU 占用高等问题。它能打印指定 Java 进程中所有线程的当前调用栈（即线程快照），对定位死锁尤其有效——因为 jstack 会明确标出“Found one Java-level deadlock”并列出相互等待的线程和锁。

确认目标 Java 进程 PID

使用 jps -l 查看本机所有 Java 进程及其主类或 JAR 路径，快速识别目标进程：

jps -l
12345 /path/to/app.jar
67890 com.example.Main

也可配合 ps 和 grep 筛选：

ps aux | grep java | grep -v grep

注意：确保执行用户与启动 Java 进程的用户一致，否则可能因权限不足无法 attach。

用 jstack 导出线程快照（含死锁检测）

直接运行以下命令即可输出线程信息到控制台，jstack 会自动检测并高亮死锁：

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

jstack 12345

更推荐将结果保存为文件，便于反复查看或分享分析：

jstack 12345 > thread_dump.txt

若进程响应慢或挂起，可加 -F 强制 dump（需 root 或进程同用户权限）：

jstack -F 12345 > thread_dump_force.txt

识别死锁的关键线索

在 jstack 输出中重点查找以下内容：

• 出现 "Found one Java-level deadlock" 段落，下面会列出所有卷入死锁的线程
• 每个死锁线程会显示其 waiting to lock（想获取但被占有的锁）和 locked（自己已持有的锁）
• 典型模式是：线程 A 持有锁 L1，等待锁 L2；线程 B 持有锁 L2，等待锁 L1
• 注意区分 java.util.concurrent 中的显式锁（如 ReentrantLock）和 synchronized 锁（显示为 monitor 或 locked ）

结合代码定位问题根源

拿到死锁线程的堆栈后，顺藤摸瓜查源码：

• 根据 stack trace 中的类名、方法名、行号，定位到同步块或 lock() 调用位置
• 检查是否按固定顺序获取多个锁（如 always lock A then B），避免交叉加锁
• 确认是否在持有锁期间调用了外部不可控方法（如 IO、远程调用），导致锁持有时间过长甚至阻塞
• 考虑用 tryLock(timeout) 替代无条件 lock，或用 ReentrantLock#newCondition() 实现更可控的等待逻辑

不复杂但容易忽略。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南