JupyterHub访问显示Jupyter Notebook而非Jupyter Lab如何解决

1. 确认基础依赖已安装 #

JupyterLab和对应Hub适配包未安装会导致labhub命令失效，先执行校验：

• 检查依赖是否存在：pip list | grep jupyterlab
• 若缺少依赖执行安装：pip install jupyterlab jupyterlab-hub
• 若使用conda环境部署，需确认JupyterHub启动加载的环境与安装上述依赖的环境为同一个，避免环境隔离导致命令找不到

2. 补全并校验配置文件 #

仅配置Spawner.cmd不足以指定默认界面，需要额外补充默认路径配置，同时确认配置文件加载路径正确：

• 在你的配置文件中追加如下配置：

  c.Spawner.default_url = '/lab'
  

• 确认你修改的配置文件为JupyterHub启动时实际加载的文件：默认全局配置路径为/etc/jupyterhub/jupyterhub_config.py，启动时可显式指定配置路径验证：jupyterhub -f /你的配置文件路径/jupyter_config.py

3. 清除旧的界面偏好设置 #

JupyterHub会保存用户的历史界面选择，全局配置修改后可能被用户侧的旧偏好覆盖：

• 手动访问你的JupyterHub地址/lab进入Lab界面，点击顶部菜单帮助 -> 设置默认界面，选择JupyterLab为默认
• 也可以删除相应用户家目录下.jupyter/lab/workspaces目录中的配置文件，清除历史偏好
• 清除浏览器缓存后重新访问验证

4. 重启服务生效配置 #

配置修改后必须重启JupyterHub主进程才会生效：

• 若使用systemd管理JupyterHub服务，执行：systemctl restart jupyterhub
• 重启后可查看日志排查报错：journalctl -u jupyterhub -f，如果出现jupyter-labhub命令不存在的报错，优先检查依赖安装和环境匹配问题

内容的提问来源于stack exchange，提问作者肖建雄