Python使用上下文管理器实现进程超时为何异常延迟到阻塞结束触发

云上老周

2026-10-7

现象原因

这个问题是Python的中断投递机制和C实现的阻塞系统调用的特性共同导致的：

_thread.interrupt_main()是Python解释器提供的方法，仅会给主线程标记一个待投递的KeyboardInterrupt异常，不会直接打断C语言层面的阻塞调用。这个异常只有当主线程回到Python字节码解释器的执行流程时，才会被检测到并抛出。
time.sleep()是完全由C语言实现的阻塞系统调用，在sleep的等待过程中，主线程不会执行任何Python字节码，也就不会检查待投递的异常，必须等sleep时长到期、系统调用返回之后，才会回到Python解释器的执行流程，此时才会抛出之前标记的KeyboardInterrupt，这就是你看到需要等5秒才输出异常的原因。
你提到的"单独运行Timer代码异常会立刻触发"，是因为测试时Timer启动后，主线程执行的是纯Python实现的逻辑（比如循环运算），此时解释器会定期检查待投递的中断，所以会立刻抛出异常；如果此时你主线程也执行time.sleep(5)，同样会等待5秒才抛出异常。

可行实现方案

如果要实现能打断sleep这类阻塞调用的超时逻辑，应该使用操作系统层面的信号机制而非线程注入中断，示例代码如下：

import signal
import time
from contextlib import contextmanager

class TimeoutException(Exception):
    pass

@contextmanager
def raise_timeout(timeout):
    def timeout_handler(signum, frame):
        raise TimeoutException(f"timeout after {timeout} seconds")
    
    # 注册SIGALRM信号的处理函数
    signal.signal(signal.SIGALRM, timeout_handler)
    # 设置超时定时器
    signal.alarm(timeout)

    try:
        yield
    finally:
        # 取消未触发的定时器
        signal.alarm(0)

# 测试代码
with raise_timeout(1):
    time.sleep(5)