运行Kubeflow教程Notebook遇500错误及后续404认证问题

问题1：ApiException: (500) Internal Server Error（请求缺少用户身份头） #

原因 #

Kubeflow的API接口强制要求请求携带用户身份头，未提供时后端服务会返回500内部错误。

解决步骤 #

• 手动给API请求添加身份头：调用Kubeflow API时，显式添加kubeflow-userid请求头，值设为你在Kubeflow中的用户名（默认一般是user@example.com）。示例代码：

  import kfp
  client = kfp.Client(host='http://localhost:8080/pipeline')
  # 注入用户身份头
  client._context._headers['kubeflow-userid'] = 'user@example.com'
  

• 配置Notebook的用户身份环境变量：如果是在Notebook中调用API，确保Notebook Pod已设置KUBEFLOW_USERID环境变量，值为你的Kubeflow用户名。部分Kubeflow部署会自动注入该变量，若没有则需要在启动Notebook时手动添加。

问题2：kubectl port-forward后requests会话认证出现404及KeyError: 'authservice_session' #

原因 #

• 端口转发的目标服务或端口错误，导致请求无法到达认证服务（authservice）
• 直接用requests会话访问时，未完成authservice的登录流程，无法获取authservice_session认证Cookie；或者访问的API路径不正确，触发404。

解决步骤 #

1. 修正port-forward命令：
   必须转发Kubeflow的authservice服务，而不是直接转发pipeline服务。正确命令如下（确保在kubeflow命名空间下操作）：

   kubectl port-forward svc/authservice 8080:8080 -n kubeflow
   

2. 完成认证流程获取会话Cookie：
   使用requests访问前，先通过authservice的登录接口完成认证，获取authservice_session Cookie后再访问API。示例代码：

   import requests
   
   session = requests.Session()
   # 发送登录请求，替换为你的Kubeflow用户名和密码
   login_payload = {'login': 'user@example.com', 'password': '12341234'}
   session.post('http://localhost:8080/login', data=login_payload)
   
   # 检查是否成功获取认证Cookie
   if 'authservice_session' not in session.cookies:
       raise RuntimeError('登录失败，未获取到认证会话Cookie')
   
   # 用已认证的会话访问Kubeflow Pipeline API
   resp = session.get('http://localhost:8080/pipeline/apis/v1beta1/pipelines')
   print(f"API响应状态码: {resp.status_code}")
   

3. 核对API访问路径：
   确保请求的API路径完整，比如Kubeflow Pipeline的API前缀是/pipeline/apis/v1beta1/，遗漏前缀会导致404错误。

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