Jupyter Notebook内核连接失败问题求助

排查与修复步骤 #

• 检查并修改Jupyter配置

  1. 生成配置文件：jupyter notebook --generate-config
  2. 打开配置文件（路径：Linux/macOS为~/.jupyter/jupyter_notebook_config.py，Windows为C:\Users\<你的用户名>\.jupyter\jupyter_notebook_config.py），调整以下参数：
     • 设置c.NotebookApp.ip = '127.0.0.1'或'0.0.0.0'
     • 确保c.NotebookApp.port为未被占用的端口（默认8888）
     • 若不需要密码验证，注释掉c.NotebookApp.password和c.NotebookApp.token行；若需要验证，执行jupyter notebook list查看当前有效token
  3. 保存配置后重启Jupyter

• 重置Jupyter组件

  1. 卸载现有Jupyter相关包：

     pip uninstall -y jupyter jupyter_core jupyter_client ipykernel nbconvert notebook
     

  2. 删除残留配置目录：Linux/macOS执行rm -rf ~/.jupyter/，Windows手动删除C:\Users\<你的用户名>\.jupyter
  3. 重新安装Jupyter：pip install jupyter（conda环境改用conda install -c conda-forge jupyter）

• 检查端口与防火墙

  1. 检查默认端口8888是否被占用：
     • Linux/macOS：lsof -i :8888
     • Windows：netstat -ano | findstr :8888
  2. 若端口被占用，杀死对应进程，或指定其他端口启动：jupyter notebook --port 8889
  3. 临时关闭系统防火墙，测试是否是防火墙拦截了连接

• 验证conda环境有效性

  1. 确保激活了目标conda环境：conda activate <你的环境名>
  2. 更新conda及所有包：conda update --all
  3. 安装并关联ipykernel到Jupyter：

     conda install ipykernel
     python -m ipykernel install --user --name=<你的环境名>
     

额外测试 #

直接复制Jupyter终端输出中带token的完整URL，手动粘贴到浏览器地址栏，确认是否能正常访问。

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