Google Vertex UI内核名称显示异常问题求助

核心原因 #

Vertex AI Notebooks的内核识别逻辑和标准Jupyter（如JupyterHub）存在差异：它不仅依赖kernel.json中的display_name，还会优先读取内核目录的名称作为唯一标识。如果多个Conda环境对应的内核目录名重复，UI就会将它们识别为同一个内核，即使display_name设置不同。

具体解决步骤 #

1. 定位内核目录
   打开Vertex Notebook的终端，运行以下命令查看所有已安装的内核路径：

   jupyter kernelspec list
   

   通常用户级内核在~/.local/share/jupyter/kernels/，系统级内核在/opt/conda/share/jupyter/kernels/。

2. 修正重复的内核目录名

   • 找到所有名称重复的内核目录（比如多个目录都叫conda_env），将它们重命名为与Conda环境对应的唯一名称，例如conda-my-data-env、conda-ml-training-env。
   • 进入每个重命名后的目录，打开kernel.json文件，确认：
     • argv中的Python路径指向对应Conda环境的解释器（比如/opt/conda/envs/my-data-env/bin/python）
     • display_name设置为你想要在UI中显示的名称

3. 刷新内核缓存并重启

   • 再次运行jupyter kernelspec list，确认所有内核目录名唯一且路径正确。
   • 重启Vertex Notebook实例，或者在UI中点击「Kernel」→「Restart Kernel」，然后刷新页面查看内核列表。

额外排查点 #

• 检查Conda环境的初始化脚本（如~/.bashrc、~/.zshrc），确保没有修改Jupyter的内核搜索路径或覆盖内核配置。
• 对比JupyterHub的内核配置：JupyterHub可能使用系统级内核目录，而Vertex默认使用用户级目录，若存在权限问题也可能导致识别异常。

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