VSCode连接Jupyter服务器及启动Glue PySpark内核超时问题排查

1. 清理重复的Jupyter Server缓存配置 #

• 打开VSCode命令面板（Ctrl+Shift+P / Cmd+Shift+P）
• 输入Jupyter: Remove Jupyter Server，选中对应URL的服务器条目删除
• 关闭并重启VSCode，再重新尝试添加服务器

2. 正确配置服务器连接的Token #

• 命令行启动Jupyter时，确认启动命令包含--NotebookApp.token='tokenvalue'，保证token固定一致
• 在VSCode中添加服务器时，只填写http://127.0.0.1:8888，不要带后面的?token=tokenvalue，然后在弹出的输入框手动输入tokenvalue
• 检查VSCode的Jupyter面板，确认服务器显示“已连接”状态

3. 调整Jupyter Server的权限设置 #

• 若未生成过Jupyter配置文件，先执行jupyter notebook --generate-config生成
• 打开配置文件，修改以下参数：

  c.NotebookApp.allow_origin = '*'
  c.NotebookApp.allow_remote_access = True
  c.NotebookApp.disable_check_xsrf = True
  

• 重启Jupyter Server，让配置生效

4. 排查Glue PySpark内核的启动问题 #

• 先在浏览器的Jupyter Notebook里运行同样的%profile saml和%idle_timeout 15代码单元，确认内核能正常启动
• 如果浏览器里正常，回到VSCode重复步骤1-3；如果浏览器里也报错，检查当前用户的SAML认证权限、Glue依赖是否安装完整
• 暂时把%idle_timeout调大到60，避免内核未启动就触发超时

5. 检查日志定位细节 #

• 查看Jupyter Server的日志，重点找403错误对应的请求路径，确认是否是内核启动相关接口被拦截
• 查看VSCode的Jupyter扩展日志，确认连接时的token传递是否正确

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