pytest无法避免多线程死锁，因其不管理线程生命周期；pytest-xdist和concurrentpytest仅并行执行测试，不干预内部锁逻辑；安全做法是统一锁顺序、设超时、显式join并检查线程状态。
pytest 本身不管理线程生命周期，多线程死锁必须在测试代码内部预防，而不是靠 pytest 插件解决。
为什么 pytest-xdist 或 concurrentpytest 无法避免死锁
pytest-xdist 启动多个进程，concurrentpytest 启动多个线程，但它们只负责并行执行测试函数，**不介入你测试函数内部的锁逻辑**。如果你的 test_something() 里手动创建了 threading.Thread 并用 threading.Lock 交叉加锁，死锁照常发生 —— 这和 pytest 是单进程还是多进程无关。
- pytest-xdist 的每个 worker 是独立进程，彼此内存隔离，但单个测试函数内仍可能因锁顺序错乱而死锁
- concurrentpytest 的线程共享全局解释器（GIL），但锁竞争发生在用户层，GIL 不阻止
Lock.acquire()阻塞 - 所有插件都假设测试是“幂等、无状态、快速退出”的；一旦线程卡在
lock.acquire()，整个 worker 就挂住
如何在测试函数中安全使用多线程
核心原则：**不让线程在测试结束前处于不可控等待状态**。重点不是“怎么启动线程”，而是“怎么确保它一定结束”。
- 永远用
thread.join(timeout=)，且 timeout 必须设为明确值（如2），不能省略或传None - 避免在测试中直接操作裸
threading.Lock；改用threading.RLock或更高级的同步原语（如threading.Event）来减少嵌套等待 - 若必须测试锁行为，用
lock.acquire(timeout=0.5)替代无限等待，并检查返回值：if not acquired: raise RuntimeError("lock not available") - 测试结束后，显式调用
threading._shutdown()不推荐；应确保所有线程已自然退出或被join()收回
典型死锁测试代码及修复对比
下面这个测试会大概率卡死：
立即学习“Python免费学习笔记（深入）”；
import threading
import time
<p>def test_deadlock_prone():
lock_a = threading.Lock()
lock_b = threading.Lock()</p><pre class="brush:php;toolbar:false;">def thread1():
with lock_a:
time.sleep(0.1)
with lock_b: # 可能永远等不到
pass
def thread2():
with lock_b:
time.sleep(0.1)
with lock_a: # 可能永远等不到
pass
t1 = threading.Thread(target=thread1)
t2 = threading.Thread(target=thread2)
t1.start(); t2.start()
t1.join(); t2.join() # 这里 hang 住
改成安全写法：
def test_safe_lock_order():
lock_a = threading.Lock()
lock_b = threading.Lock()
<pre class="brush:php;toolbar:false;"># 强制统一顺序：所有线程先 a 后 b
def worker():
assert lock_a.acquire(timeout=1), "failed to acquire lock_a"
try:
assert lock_b.acquire(timeout=1), "failed to acquire lock_b"
try:
pass # work
finally:
lock_b.release()
finally:
lock_a.release()
t = threading.Thread(target=worker)
t.start()
t.join(timeout=2) # 给足时间，超时即报错
assert not t.is_alive(), "thread did not exit in time"
容易被忽略的关键点
很多人以为加了 timeout 就万事大吉，但实际还有三个坑：
-
threading.Lock.acquire(timeout=...)返回False时不抛异常，容易被静默忽略 - 主线程调用
t.join(timeout=...)后，若返回False（线程还在跑），你没做任何清理，下次运行可能复用残留状态 - pytest 默认不捕获子线程中的未处理异常；线程内崩溃不会让测试失败，只会悄无声息消失
