Ubuntu下Jupyter Notebook升级tornado后无法连接服务器问题求助

问题原因 #

你最初的报错是tornado版本低于Jupyter Notebook的最低依赖要求，手动安装5.0/5.1.1版本后出现连接失败，是因为这两个版本的tornado和你当前安装的Jupyter Notebook版本存在websocket连接兼容缺陷，导致前端无法和后端服务建立通信。

解决方案 #

方案一：安装适配稳定的版本组合 #

• 先清理所有冲突的现有包，避免多版本共存导致的异常

pip uninstall -y tornado jupyter notebook

• 安装经过验证的兼容版本组合

pip install tornado==6.2 jupyter notebook

• 启动服务测试，使用终端输出的带token的完整链接访问，不要用旧的收藏链接，避免token过期或缓存问题

jupyter notebook --no-browser

方案二：排查端口和缓存问题 #

如果方案一执行后仍有异常，按以下步骤排查：

• 检查Jupyter默认端口8888是否被占用，若有输出则终止对应进程，或启动时指定其他端口

# 检查端口占用
lsof -i:8888
# 启动时指定其他端口
jupyter notebook --port 8889

• 清空浏览器缓存，或使用无痕模式访问，避免前端异常缓存导致连接失败

方案三：解决系统级包冲突 #

Ubuntu系统预安装的Jupyter包可能和用户pip安装的版本产生冲突，执行以下命令卸载系统级Jupyter包后重新启动服务即可

sudo apt remove -y jupyter-core jupyter-notebook

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