通过VS Code连接本地Jupyter Server时出现404错误求助

问题现象 #

• 本地Jupyter Server通过浏览器访问http://127.0.0.1:8888/lab完全正常，但VS Code连接时会发起对不存在路径的GET请求，导致连接失败
• 尝试连接内核时，Jupyter Server输出以下错误日志：

[W 2023-10-13 11:39:13.850 ServerApp] 404 GET /hub/api (3d6066d144c148199057cfc52d470e24@172.17.0.1) 4.36ms referer=None
[W 2023-10-13 11:39:13.869 ServerApp] 404 GET /login? (cb81710be7fe4ba684e58543fe1d95d7@172.17.0.1) 1.78ms referer=None

已尝试操作 #

• 重装VS Code中的Jupyter Notebook扩展

可行解决思路 #

• 修正VS Code的服务器配置
  打开VS Code设置，搜索jupyter server，确保设置的服务器URL是http://127.0.0.1:8888（不要带/hub后缀，因为你运行的是单用户Jupyter Server，不是JupyterHub）。同时确认已勾选Jupyter: Use Existing Server，并填入正确的服务器token（可从Jupyter启动日志或浏览器访问URL的token参数中获取）。

• 重置扩展配置
  打开命令面板（Ctrl+Shift+P），输入Preferences: Open Settings (JSON)，删除所有与Jupyter相关的自定义配置项，保存后重启VS Code再尝试连接。

• 检查Jupyter Server启动方式
  确保启动Jupyter时用的是jupyter lab或jupyter notebook命令，而非JupyterHub相关命令。可以完全关闭现有Jupyter进程，重新启动生成新的token后再在VS Code中配置。

• 验证服务器API可用性
  在浏览器访问http://127.0.0.1:8888/api，若能返回JSON格式的响应，说明服务器API正常，VS Code应该能正确识别。

• 降级扩展版本
  如果是新版本Jupyter扩展的兼容性问题，可在VS Code扩展市场找到该扩展，点击右上角齿轮图标选择Install Another Version，安装一个稍旧的稳定版本后重试。

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