0

0

Python 线程死锁的排查方法

舞夢輝影

舞夢輝影

发布时间:2026-02-24 08:10:09

|

966人浏览过

|

来源于php中文网

原创

快速确认线程死锁需先观察现象:多线程长期停在lock.acquire()、rlock.acquire()或queue.get()且cpu占用极低;再用kill -usr1(linux/macos)或sys._current_frames()打印线程栈,重点检查停在acquire/wait/__enter__的线程。

python 线程死锁的排查方法

怎么快速确认是不是线程死锁 Python 里线程卡住不一定是死锁,可能是 I/O 阻塞、长时间计算或 time.sleep()。真要怀疑死锁,先看现象:多个线程长期停在 threading.Lock.acquire()threading.RLock.acquire()queue.Queue.get() 上,且 CPU 占用极低。 最直接的办法是发信号触发线程栈打印:

Linux/macOS 下用 kill -USR1 <pid></pid>(需 Python 启动时未忽略该信号);Windows 不支持,得靠 sys._current_frames() 手动抓。

更稳的实操是加一句调试钩子:

import threading, sys, traceback
def dump_threads():
    for thread_id, frame in sys._current_frames().items():
        print(f"Thread {thread_id}:")
        traceback.print_stack(frame, limit=5)

在疑似卡住时调用它,重点看哪些线程停在 acquirewait__enter__ 上。

常见死锁模式和对应修复 死锁不是玄学,基本就那几类写法,改起来也快:

• 嵌套锁顺序不一致:
线程 A 先 lock1 再 lock2,线程 B 先 lock2 再 lock1 → 必现死锁。
→ 统一加锁顺序,比如按 id(lock1) 判断谁先 acquire。

• RLock 误用:
RLock 允许同一线程重复 acquire,但若不同线程交叉调用且没配对 release,照样卡死。
→ 检查每个 acquire() 是否都有对应 release(),尤其异常分支里漏了 release

• Queue + Lock 混用不当:
一边用 queue.get(block=True) 等数据,另一边用锁保护队列操作却忘了 notify 或 put —— 实际是逻辑卡点,不是锁本身问题。
→ 改用 queue.put_nowait() + try/except queue.Full 显式处理,避免无限等。

用 threading.settrace() 监控锁行为(慎用) 这不是日常手段,但排查疑难死锁很管用:给所有线程装上 trace 函数,记录每次 acquirerelease

要点:

立即学习Python免费学习笔记(深入)”;

• 只在 debug 模式启用,性能损耗大,会拖慢 5–10 倍;

• trace 函数必须轻量,别 print,改用 logging.debug 写文件;

小绿鲸英文文献阅读器
小绿鲸英文文献阅读器

英文文献阅读器,专注提高SCI阅读效率

下载

• 关键是记下线程名、锁对象 id、调用栈前两层(用 frame.f_code.co_nameframe.f_lineno);

• 死锁发生后,搜日志里“acquire”但没对应“release”的锁 id,再查哪些线程在等它。

为什么 logging.getLogger().addHandler() 会隐式触发死锁 这个坑很多人踩过:多线程环境下,第一次调用 logging.info() 会懒加载 logger 层级结构,内部用了模块级锁 _lock;如果此时另一个线程正持有该锁又去调 threading.Lock.acquire(),而前者又反过来等那个 Lock —— 就串起来了。

表现就是:程序启动后某次 log 调用突然卡死,堆栈停在 logging/__init__.py_acquireLock

解决办法只有两个:

• 启动时主线程先执行一次 logging.debug("init"),提前初始化锁;

• 或彻底避开 logging 在锁临界区里调用 —— 把日志内容先拼好,出锁后再 logging.info(msg)

锁的嵌套深度、跨线程传递、和 logging/queue/condition 的交互,才是真实项目里死锁反复出现的根因。盯住 acquire/release 是否成对、是否跨线程、是否混用不同同步原语,比背原理有用得多。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
python中print函数的用法
python中print函数的用法

python中print函数的语法是“print(value1, value2, ..., sep=' ', end=' ', file=sys.stdout, flush=False)”。本专题为大家提供print相关的文章、下载、课程内容,供大家免费下载体验。

192

2023.09.27

python print用法与作用
python print用法与作用

本专题整合了python print的用法、作用、函数功能相关内容,阅读专题下面的文章了解更多详细教程。

13

2026.02.03

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

422

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

595

2023.08.10

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

422

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

595

2023.08.10

线程和进程的区别
线程和进程的区别

线程和进程的区别:线程是进程的一部分,用于实现并发和并行操作,而线程共享进程的资源,通信更方便快捷,切换开销较小。本专题为大家提供线程和进程区别相关的各种文章、以及下载和课程。

719

2023.08.10

Python 多线程与异步编程实战
Python 多线程与异步编程实战

本专题系统讲解 Python 多线程与异步编程的核心概念与实战技巧,包括 threading 模块基础、线程同步机制、GIL 原理、asyncio 异步任务管理、协程与事件循环、任务调度与异常处理。通过实战示例,帮助学习者掌握 如何构建高性能、多任务并发的 Python 应用。

371

2025.12.24

苹果官网入口与在线访问指南_中国站点快速直达与iPhone查看方法
苹果官网入口与在线访问指南_中国站点快速直达与iPhone查看方法

本专题汇总苹果官网最新可用入口及中国站点访问方式,涵盖官网直达链接、iPhone官方页面查看方法与常见访问说明,帮助用户快速进入苹果官方网站,便捷了解产品信息与官方服务。

2

2026.02.24

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.7万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号