Windows环境下Python3.10搭配PyZMQ23.3.0无法触发键盘中断

这不是个别问题 #

这是PyZMQ 23.x版本在Windows系统搭配Python3.10+时的兼容性bug，根源是Python3.10修改了信号处理的底层逻辑，而PyZMQ23.x的Windows信号适配代码没跟上。

问题原因拆解 #

1. 官方示例为何失效？ #

PyZMQ在Windows下使用的IO多路复用机制（比如zmq.Poller）会阻塞Python的信号处理线程。Windows的信号模型和Unix完全不同，PyZMQ23.x的底层实现会直接吞掉SIGINT信号，导致Python解释器根本捕获不到KeyboardInterrupt异常。

2. 为何设置signal.SIGINT, signal.SIG_DFL后无法执行清理逻辑？ #

signal.SIG_DFL是让操作系统直接处理中断信号，此时进程会被立即终止，Python解释器没有机会执行finally块、print语句这类用户态的清理或输出逻辑，相当于被强制Kill，自然走不到后续代码。

可行解决方案 #

• 降级PyZMQ到22.x版本：比如安装pyzmq==22.3.0，这个版本在Windows+Python3.10下的信号处理逻辑是正常的，官方示例的KeyboardInterrupt能被正常捕获，finally块的清理代码也能执行。
• 修改代码为非阻塞轮询模式：给poll()设置一个短超时，再配合短暂休眠，让Python解释器有机会处理信号。示例代码如下：

  import zmq
  import signal
  import time
  
  def main():
      context = zmq.Context()
      socket = context.socket(zmq.REP)
      socket.bind("tcp://*:5555")
  
      poller = zmq.Poller()
      poller.register(socket, zmq.POLLIN)
  
      try:
          while True:
              # 设置100ms超时，避免永久阻塞
              socks = dict(poller.poll(100))
              if socket in socks:
                  message = socket.recv()
                  print(f"收到消息: {message}")
                  socket.send(b"World")
              # 短暂休眠，给信号处理留时间
              time.sleep(0.01)
      except KeyboardInterrupt:
          print("捕获到键盘中断，开始清理资源")
      finally:
          socket.close()
          context.term()
          print("资源已成功释放")
  
  if __name__ == "__main__":
      # 使用Python默认的信号处理函数，避免ZMQ吞掉信号
      signal.signal(signal.SIGINT, signal.default_int_handler)
      main()
  

• 升级PyZMQ到24.x及以上版本：后续版本已经修复了Windows+Python3.10的信号适配问题，官方示例可以正常捕获KeyboardInterrupt，无需额外修改代码。

内容的提问来源于stack exchange，提问作者will.mendil