ArcGIS Pro 3.1.0内核启动失败（AttributeError）问题求助

API 探路者

2026-7-24

解决ArcGIS Pro 3.1.0中"Failed to start the kernel"（AttributeError: 'IOLoopKernelManager'）的方案

降级jupyter相关包到兼容版本
ArcGIS Pro的Python环境对jupyter组件版本要求严格，这个错误大概率是jupyter_client或ipykernel版本过高导致的。打开ArcGIS Pro自带的Python Command Prompt，执行以下命令：
```
pip install jupyter_client==7.4.9 ipykernel==6.25.0
```
这两个版本和ArcGIS Pro 3.1.0兼容，安装后重启ArcGIS Pro和VS Code（如果用VS Code连接的话）。
清理环境变量冲突
检查系统环境变量的PATH，把ArcGIS Pro自带的Python路径（一般是C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3）移到Anaconda、其他Python版本路径的最前面。避免系统优先调用其他环境的jupyter组件，修改后重启电脑生效。
重置ArcGIS Pro Python环境
打开ArcGIS Pro，点顶部菜单栏的Project -> Python -> Manage Environments，选默认的arcgispro-py3环境，点击Reset。这个操作会把环境恢复到初始状态，覆盖被篡改的包配置。
固定VS Code的Python解释器（如果用VS Code运行脚本）
在VS Code设置里搜Python: Default Interpreter Path，手动指定为ArcGIS Pro的Python解释器路径（C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3\python.exe），同时关掉Python: Auto Detect选项，防止VS Code自动切换到冲突环境。
排查外部软件干扰
有些杀毒软件、系统优化工具可能会修改Python环境配置文件。暂时关闭这类软件，再重启ArcGIS Pro运行脚本，看看是不是外部程序搞的鬼。