命令行升级pip后Jupyter Notebook打开空白无法正常使用求助
Jupyter Notebook 跳转空白问题解决步骤
该故障核心是Jupyter启动流程异常,关联触发点包括:pip升级操作导致的路径错位、依赖包版本不兼容,或是Jupyter 6.3.0版本原生前端跳转bug、端口占用导致服务无法正常启动。
1. 排查端口占用问题
- 执行命令查看8888端口占用情况:
netstat -ano | findstr :8888 - 若输出存在结果,记录最后一列的进程PID号,执行命令强制结束对应进程:
taskkill /PID <查询到的PID号> /F - 释放端口后再测试启动Jupyter
2. 优先验证服务运行状态
- 无需等待自动打开的空白页,直接复制命令行日志中带token的完整地址,例如
http://localhost:8888/?token=767d91ee67804085a541023b7f49efa33d0a3cddb17be4c6 - 手动粘贴到其他浏览器地址栏访问(替换默认浏览器测试,如默认Edge就换Chrome)
- 若可正常进入Jupyter界面,说明仅为自动跳转逻辑异常,核心服务未损坏
3. 修复自动跳转异常
- 关闭所有运行中的Jupyter进程:在对应命令行窗口按两次
Ctrl+C,或直接关闭所有启动过Jupyter的命令行窗口 - 执行命令生成默认Jupyter配置:
jupyter notebook --generate-config,若提示配置文件已存在,选择Y覆盖即可 - 重新执行
jupyter notebook启动服务,等待自动跳转即可正常打开
4. 手动访问仍空白的依赖修复方案
若粘贴带token的地址仍为空白页,说明pip升级过程中损坏了Jupyter核心依赖,执行以下操作修复:
- 卸载现有Jupyter相关组件:
pip uninstall -y jupyter notebook - 安装稳定兼容版本的Jupyter:
pip install jupyter notebook==6.4.12(该版本规避了6.3.0的原生前端跳转bug) - 安装完成后重新执行
jupyter notebook启动即可
补充:pip升级的正确操作方式
你当前在C:\Python\Python39\Scripts路径下执行pip操作,容易出现多Python环境路径混淆的问题。后续升级pip统一执行命令:python -m pip install --upgrade pip
该命令会直接调用当前环境对应的pip程序,避免路径错位导致的依赖安装异常。
内容的提问来源于stack exchange,提问作者Jesus Trejo
相关产品推荐
相关产品推荐

