GCP用户托管JupyterLab内核持续连接状态故障求助

• 检查实例资源占用
  登录GCP控制台查看VM实例的CPU、内存及磁盘使用率：

  • 如果CPU/内存跑满，内核无法启动，可升级实例规格，或清理实例内大文件、缓存释放资源。
  • 登录实例后用命令top或htop实时查看进程资源占用，定位消耗资源的进程并终止。

• 查看JupyterLab日志排查报错
  登录实例后查看JupyterLab日志文件，路径通常为~/.jupyter/logs/，执行命令：

  tail -f ~/.jupyter/logs/jupyterlab.log
  

  从日志中定位内核启动失败的具体原因（如依赖缺失、权限错误等）。

• 重建或更换内核环境

  • 创建全新虚拟环境并添加内核：

    python -m venv new_kernel_env
    source new_kernel_env/bin/activate
    pip install ipykernel
    python -m ipykernel install --user --name new_kernel_env --display-name "New Kernel Env"
    

    之后在JupyterLab中切换到新内核尝试连接。
  • 升级现有内核依赖包，修复版本冲突：

    pip install --upgrade ipykernel jupyter_client
    

• 检查网络与端口配置

  • 确认GCP实例防火墙规则允许JupyterLab默认端口（8888）的入站流量，同时确保内核通信的随机端口范围未被限制。
  • 若使用SSH隧道连接，重新建立隧道：

    gcloud compute ssh <你的实例名称> -- -L 8888:localhost:8888
    

• 重置JupyterLab配置
  备份现有配置后重置：

  mv ~/.jupyter/jupyter_notebook_config.py ~/.jupyter/jupyter_notebook_config.py.bak
  

  重启JupyterLab，使用默认配置测试是否恢复正常。

• 修复目录权限问题
  确保Jupyter运行用户对内核配置目录有读写权限：

  chown -R $USER:$USER ~/.local/share/jupyter/
  

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