VSCode 调试 Python 多线程死锁时的线程挂起定位技巧

酷雪姑娘_7169

酷雪姑娘_7169

2026-06-22

370人浏览

原创

确认死锁需先ctrl+c查看线程栈:若多线程同停在acquire()且id相同,或a持lock_a等lock_b、b持lock_b等lock_a,即为死锁;调试须设subprocess:true和justmycode:false。

vscode 调试 python 多线程死锁时的线程挂起定位技巧

断点卡在 Lock.acquire() 但没报错,怎么确认是死锁?

死锁不会抛异常,程序只是不动——这时候别急着改代码,先看线程是否真挂住了。最直接的办法是手动中断:运行中按 Ctrl+C,Python 会强制打印所有线程当前调用栈。重点扫三类信息:

  • 多个线程都停在 Lock.acquire() 或 RLock.acquire(),且传入的是同一个 Lock 对象(id(lock) 相同)
  • 线程 A 显示刚拿到 lock_a,下一步正等 lock_b;线程 B 刚拿到 lock_b,正等 lock_a
  • 堆栈里出现 threading.Thread.run → 你的函数名 → acquire,说明阻塞点就在你代码里,不是底层调度问题

如果中断后没输出,或只看到主线程堆栈,说明调试器没捕获子线程——得先解决调试配置问题。

launch.json 里必须加的两项:为什么 subProcess: true 和 justMyCode: false 缺一不可

VS Code 默认只跟踪主线程,子线程里的 acquire() 调用根本进不了调试器视野。仅设 justMyCode: false 不够,它只让调试器不跳过标准库帧,但依然不监听新线程;必须同时开 subProcess: true,debugpy 才会注入每个 threading.Thread 实例。

  • subProcess: true:启用子进程/子线程级调试注入,threading.Thread、ThreadPoolExecutor 启动的线程全被接管
  • justMyCode: false:避免调试器在进入 threading.py 的 _bootstrap 方法时“丢帧”,否则你的 worker() 函数可能直接被跳过
  • 别设 stopOnEntry: true:它只对主线程生效,反而会让调试器在启动时卡住,错过子线程初始化时机

验证是否生效:写个两行脚本,time.sleep(0.1) 后打个断点,跑起来看断点是不是实心圆、悬停有没有提示 “Breakpoint hit”。不是?配置还没生效。

361SCAN security check your skill python scripts
361SCAN security check your skill python scripts

扫描并分析已安装技能,用于查看指定技能目录的名称、描述和详情,或列出所有已安装的技能。

下载

切换线程上下文看谁持有了锁,而不是谁在等

VS Code 调试器暂停后,“CALL STACK”面板顶部会出现下拉菜单,列出所有活动线程。死锁排查的关键不是看谁卡在 acquire(),而是找那个“已经拿到锁、却迟迟不释放”的线程。

  • 逐个点击线程,看它的调用栈末端是不是停在你代码的临界区内部(比如刚执行完 lock_a.acquire(),还没走到 lock_a.release())
  • 检查该线程的局部变量和“VARIABLES”面板里的共享对象状态,确认它是否因异常、return 缺失或逻辑分支没覆盖,导致 release() 没被执行
  • 注意线程名(threading.current_thread().name)和 ID(threading.get_ident()),和日志对上,避免把 A 线程的日志误判成 B 线程的行为

如果所有线程都卡在 acquire(),但找不到任何线程持有锁——那可能是锁被主线程拿了没放,或者锁对象本身被意外重置(比如重复初始化)。

加锁日志比断点更可靠,尤其在线程快速切换场景

调试器暂停会改变线程执行节奏,有时反而掩盖死锁条件。生产环境或高频并发下,靠日志定位更稳:

  • 在每次 lock.acquire() 前打日志:f"[{threading.current_thread().name}] acquire {id(lock)} at {time.time():.3f}"
  • 在 lock.release() 后打日志:f"[{threading.current_thread().name}] release {id(lock)}"
  • 关键不是记录“做了什么”,而是记录“谁、什么时候、对哪个锁实例做了操作”——id(lock) 必须打,否则分不清是同一把锁还是不同实例

典型线索:A 线程日志显示 acquire lock1 → acquire lock2,然后没了;B 线程日志显示 acquire lock2 → acquire lock1,也停了。这基本就是循环等待,不用等程序卡死再查。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

python vscode

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1751

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4544

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1729

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

26837

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3247

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3267

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1183

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2523

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习