Jupyter Notebook报ConnectionResetError(WinError10054)致终端关闭内核终止排查

常见认知误区澄清 #

很多技术帖提到的“网络变动导致连接断开”，并不特指外网连接波动。Jupyter默认通过127.0.0.1回环地址提供服务，这类连接是由Windows本地网络栈虚拟承载的，不依赖物理网卡的外网连通性，但也并非完全和系统网络状态隔离。只要系统网络栈状态变动、关联进程的网络规则调整、甚至第三方软件的流量拦截，都会触发回环socket的强制重置——这类问题和你是否关闭网卡电源管理功能没有直接关联，自然也没法通过调整电源设置解决。
你遇到的报错栈显示，异常发生在asyncio内部的_read_from_self方法，本质是Jupyter内部用来做进程间通信的socket被意外断开，直接击穿了整个事件循环，才会导致所有挂载的Python内核被强制终止。

版本层面的已知兼容缺陷 #

你当前环境的组件组合，刚好落在存在已知bug的版本区间：jupyter_client 6.1.7 搭配Python 3.7环境时，和asyncio SelectorEventLoop的实现存在兼容问题，会偶发触发自连接recv操作的异常，最终抛出ConnectionResetError: [WinError 10054]。

可落地的排查修复步骤 #

• 优先升级匹配Python3.7的稳定组件版本
  不要在存在已知bug的旧版本上无意义排查，对应Python3.7环境的稳定修复版本组合为：将jupyter_client升级到6.1.12及以上版本、jupyterlab升级到3.2.9版本、jupyterlab_server升级到2.10.2版本。注意不要直接拉取最新版JupyterLab，过高的版本已经不再兼容Python3.7，会引入新的运行错误。
  对应的安装命令为：
  pip install jupyter_client==6.1.12 jupyterlab==3.2.9 jupyterlab_server==2.10.2
• 固定Jupyter的监听规则，减少系统网络栈的动态影响
  启动Jupyter时显式指定固定的监听地址和端口，不要使用默认的动态匹配逻辑，执行以下命令启动：
  jupyter lab --ip=127.0.0.1 --port=8888 --no-browser
  这种设置可以规避Windows网络栈在适配器状态变动时（比如VPN客户端切换、USB网卡插拔、驱动临时重载），重置已建立的本地回环连接的问题。
• 排查第三方软件的回环流量拦截
  Windows端的安全软件、网络加速器、VPN客户端会默认扫描所有本地回环的流量，一旦触发内置的流量判断规则，会主动掐断目标连接，直接抛出10054错误。这类拦截行为和硬件电源管理设置无关，可以临时完全退出这类软件，再启动Jupyter验证断连问题是否复现。
• 替换asyncio事件循环实现，规避原生bug
  如果暂时无法升级组件，可以在启动Jupyter前，通过引导脚本指定使用更稳定的Proactor事件循环替代有兼容问题的Selector事件循环，引导脚本内容如下：

  import asyncio
  import sys
  if sys.platform == "win32":
      # 替换存在已知自连接读取bug的SelectorEventLoop
      asyncio.set_event_loop_policy(asyncio.WindowsProactorEventLoopPolicy())
  from jupyterlab.labapp import main
  main()
  

  保存脚本后直接通过Python运行该脚本启动Jupyter，即可规避asyncio层的自连接读取异常问题。

内容的提问来源于stack exchange，提问作者bytesandbits