调试 Kotlin 协程
虽然协同程序特别适合异步编程,但由于异步流程带来的挑战,仍然有出错的可能,而且这些错误可能很难查明。
在调试 Kotlin 代码时,IntelliJ IDEA 允许您暂停执行并诊断协程中的代码可能存在的问题。 即使协程此刻没有运行,调试信息也可用。
在 Kotlin 文档中了解详情。
检查协程
在协程代码中或附近设置一个 断点。
以调试模式启动应用程序。
等待应用程序到达断点。
在 调试 工具窗口中,选择 协程 选项卡,该选项卡位于 布局设置 中。
该视图按调度器对协程进行分组。 展开调度器节点以查看其协程。

对于每个协程,IntelliJ IDEA 都会显示其当前状态:
创建 :协程已创建,但未运行。
运行中 :协程当前正在执行。
暂停 :协程已暂停,当前未在线程上执行。
在适用情况下,该视图还会显示协程正在执行所在的线程信息。
检查协程
在 协程 选项卡中,可以看到完整的协程创建堆栈,以及协程内的调用堆栈。 堆栈包含所有带有变量值的帧,即使是在标准调试期间会丢失的帧。

调试协程时,您可以使用 变量 选项卡的所有标准功能。 有关使用 变量 选项卡的更多信息,请参阅 检查/更新变量 主题。

如果您对 Kotlin 类中的调用不感兴趣,可以通过点击 在库中隐藏帧 隐藏它们,此选项位于 帧 选项卡的右上角。

捕获线程和协程转储文件
如果需要包含每个协程状态及其堆栈的报告,请使用 线程转储文件。
IntelliJ IDEA 的线程转储文件可以包括:
Java 平台线程
虚拟线程
检测到的 Kotlin 协程及其堆栈
获取协程转储文件
在 调试 工具窗口的工具栏上,点击
更多 ,然后选择
获取线程转储文件。

2026年 11月 3日