Jupyter Lab初始化配置报错无法打开网页但Notebook正常运行如何解决
根本原因
Jupyter从4.0版本开始重构了服务端架构,原NotebookApp下的多数配置项逐步迁移到ServerApp节点下,其中列表格式的server_extensions配置项早已被废弃,替换为字典格式的nbserver_extensions来统一管理扩展的启用状态。
你留存的配置文件中仍在NotebookApp节点下声明了已不存在的server_extensions属性,触发了配置校验的核心报错。而Jupyter Notebook能正常运行是因为旧版Notebook对遗留配置保留了兼容逻辑,Jupyter Lab的服务端启动逻辑对配置合法性校验更严格,因此直接启动失败。
规范解决方案
无需删除整个配置目录重装,按以下步骤修改即可:
- 定位到Jupyter默认配置目录
~/.jupyter/(Windows系统路径为C:\Users\当前用户名\.jupyter\),找到报错对应的jupyter_notebook_config.json配置文件 - 删除
NotebookApp节点下废弃的server_extensions数组配置,若需要保留jupyter_nbextensions_configurator扩展,直接将其添加到nbserver_extensions字典中即可,修改后参考配置如下:
{ "NotebookApp": { "nbserver_extensions": { "jupyterlab": true, "jupyter_nbextensions_configurator": true } } }
- 如果需要同时消除配置迁移的警告信息,可直接将所有配置项迁移到
ServerApp节点下,适配新版Jupyter架构的配置参考如下:
{ "ServerApp": { "nbserver_extensions": { "jupyterlab": true, "jupyter_nbextensions_configurator": true }, "browser": "你之前配置的浏览器启动路径(无自定义配置可删除该字段)", "notebook_dir": "你之前设置的 Notebook 工作目录(无自定义配置可删除该字段)" } }
- 保存修改后的配置文件,重新执行
jupyter lab即可正常启动,原有配置不会丢失。
内容的提问来源于stack exchange,提问作者William Song
相关产品推荐
相关产品推荐

