You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.06 14:36:02