线程转储
线程转储文件是一种用于检查应用程序在特定时刻状态的工具。 其中包含应用程序中的线程列表及其堆栈跟踪,可用于调试死锁或 UI 无响应等问题。 线程转储文件的主要优势在于其纯文本格式,以及有大量可捕获和处理它们的工具。
IntelliJ IDEA 可用于捕获正在运行进程的线程转储文件,也可解析在 IntelliJ IDEA 或其他工具中获取的外部线程转储文件,例如 jstack 和 jcmd 。
IntelliJ IDEA 支持最高版本 25 的 JDK 工具生成的格式。
从 IntelliJ IDEA 捕获线程转储
从 IntelliJ IDEA 运行程序时:在 运行 工具窗口的工具栏上,点击
线程转储。

从 IntelliJ IDEA 调试程序时:在 调试 工具窗口的工具栏上,点击
更多 ,然后选择
获取线程转储文件。

对于本地运行的任何 Java/Kotlin 进程:在 分析器 工具窗口的 首页 选项卡上,点击要为其创建线程转储文件的进程。 选择 获取线程转储文件。

打开外部线程转储文件
在打开的 分析堆栈跟踪 对话框中,将线程转储文件粘贴到 请在此处放置堆栈跟踪或完整的线程转储: 文本区域。
线程转储文件会在新的工具窗口选项卡中打开。 此视图是可自定义的:您可以应用筛选和排序,合并相似的线程,并部分折叠堆栈跟踪。
线程名称旁边的图标表示线程的状态:
图标 | 描述 |
|---|---|
运行中/活动 – 默认状态,线程在此状态下正在主动执行代码 | |
(对于 Kotlin 协程)运行中 – 协程正在主动执行代码 | |
休眠 – 在线程处于 | |
载体线程 – 当前正在执行虚拟线程的平台线程,或处于 已创建/未知 状态的协程 | |
| 等待 – 在线程正在等待对象监视器,或协程被挂起时发生 |
套接字 – 在线程正在执行网络 I/O 时发生 | |
I/O – 在线程正在执行非网络 I/O 操作时发生 | |
| EDT(事件调度线程)– Swing 应用程序中的 UI 线程。 |
此外,波浪形的叠加层表示虚拟线程和 Kotlin 协程,而"幽灵"叠加层表示守护线程:

在 运行 工具窗口中的某些调用具有虚线下划线。 这些调用发生在 try 块内,并且可能抛出受检异常。
如果您想检查出现在堆栈跟踪中的类,您可以直接从线程转储导航到它。
跳转到源
点击堆栈跟踪中的超链接。

如果您想保存线程转储以供以后检查或发送给其他人,您可以将其导出为文本文件。
将线程转储导出为文本文件
在工具栏上,点击 导出到文本文件。

指定路径,然后点击 保存。
IntelliJ IDEA 的线程转储文件格式
以文本格式查看 IntelliJ IDEA 的线程转储文件时,可能会注意到线程描述和堆栈跟踪中包含额外信息。
其显示效果示例如下:
转储文件中的每个线程都由以下信息表示:
线程页眉行
线程页眉行位于每个线程描述的开头,包含:
引号中的线程名称
用于指示线程是否为守护线程或虚拟线程的可选标志
线程优先级(
prio)– 由 JVM 管理的值,表示线程的调度优先级,范围从 1(最低)到 10(最高)。 默认值为 5。 这些优先级可以映射到 OS 级线程优先级,但映射取决于实现,并且优先级只是给调度器的提示,而不是执行顺序的保证。十六进制线程 ID(
tid)原生 ID (
nid) – 在 IDE 生成的转储文件中通常为NA。 此信息通常仅在线程转储文件由 JVM 本身生成时可用线程状态。 可识别以下状态:
线程状态
描述
可运行线程正在主动运行或已准备好运行
sleeping线程处于睡眠状态(
Thread.sleep())waiting on condition线程正在等待条件
waiting for monitor entry线程正在等待获取监视器锁
sleeping线程处于睡眠状态(
Thread.sleep())parking线程已停放(
LockSupport.park())on object monitor线程正在等待对象监视器
idle事件调度线程处于空闲状态
线程状态行
线程状态行紧跟在线程页眉行之后,并包含 JVM 指示的线程状态。 可能的状态如下:
线程状态 | 描述 |
|---|---|
| 尚未开始执行的线程 |
| 在 Java 虚拟机中执行的线程 |
| 被阻塞并等待监视器锁的线程 |
| 无限期等待另一个线程执行特定操作的线程 |
| 在指定等待时间内等待另一个线程执行操作的线程 |
| 已完成执行的线程 |
有关线程状态的更多信息,请参阅 官方 Java 文档。
堆栈跟踪
堆栈跟踪显示线程的方法调用序列,其特点如下:
堆栈跟踪中的每一行都以制表符字符开头。
方法调用按从上(最近/被调用的方法)到下(较早/调用方方法)的顺序列出。
每一行都遵循以下格式:
at package.class.method(SourceFile:LineNumber)。 当 IntelliJ IDEA 识别出源文件时,可以使用它 导航到源代码。
锁信息
如果可用,IntelliJ IDEA 的线程转储文件会提供线程持有的锁的信息,包括:
此线程拥有的监视器
被此线程阻塞的线程
此线程正在等待的监视器
包含类和内存地址的锁对象
Kotlin 协程
可以在 IntelliJ IDEA 的线程转储文件中查看 Kotlin 协程以及 Java 线程。 例如:
协程信息的格式如下:
名称和 ID:协程名称后跟其唯一 ID,例如
coroutine:1状态:协程的当前状态,例如
暂停调度器:有关协程正在使用的调度器的信息,例如
Dispatchers.IO堆栈跟踪:协程的堆栈帧
协程可能处于以下状态之一:
协程状态 | 描述 |
|---|---|
| 协程当前正在执行 |
| 协程在挂起点处挂起 |
| 协程已创建但尚未启动 |
| 无法确定状态 |