UI 故障排查

如果您在使用 LiteLLM 管理界面 (Admin UI) 时遇到问题，请在报告时提供以下信息。

1. 复现步骤

对如何触发该问题的清晰、分步描述（例如：“导航至 Settings → Team，点击 'Create Team'，填写字段，点击提交 → 出现错误”）。

2. LiteLLM 版本

您当前运行的 LiteLLM 版本。可通过 litellm --version 或 UI 的设置页面查看。

3. 架构与部署配置

分布式环境是已知的 UI 问题来源。请描述：

• LiteLLM 实例/副本的数量以及部署方式（例如：Kubernetes、Docker Compose、ECS）
• 负载均衡器的类型和配置（例如：ALB、Nginx、Cloudflare Tunnel）——请说明是否启用了粘性会话 (sticky sessions)
• UI 的访问方式——是直接通过 LiteLLM 访问，还是通过反向代理，或是在 Ingress Controller 后方
• 用户与 LiteLLM 服务器之间是否存在任何 CDN 或缓存层

4. 网络标签页请求

打开浏览器的开发者工具（F12 → Network 标签页），复现问题，并分享：

• 失败的请求——URL、方法、状态码和响应正文
• 相关网络活动的截图或 HAR 导出文件
• Console（控制台）标签页中显示的任何 CORS 或混合内容错误

5. 环境变量

与 UI 和代理配置相关的非敏感环境变量，例如：

• LITELLM_MASTER_KEY
• PROXY_BASE_URL / LITELLM_PROXY_BASE_URL
• UI_BASE_PATH
• 任何与 SSO 相关的变量（例如：GOOGLE_CLIENT_ID, MICROSOFT_TENANT）

请不要包含密码、机密信息或 API 密钥。

6. 浏览器与访问详情

• 浏览器及其版本（例如：Chrome 120, Firefox 121）
• 用于访问 UI 的访问 URL（请遮盖敏感部分）
• 问题是发生在所有用户身上还是特定角色（管理员、内部用户等）

7. 截图或录屏

问题的截图或简短录屏非常有帮助。请包含任何可见的错误消息、弹窗提示或异常行为。