[Bug]: MCP OAuth: persisted discovered issuer flips servers into issuer-anchored mode; one failed metadata fetch then breaks /authorize unti

问题场景

用户在 LiteLLM Proxy 中通过 API 创建一个交互式 OAuth2 MCP 服务器，请求体提供了 authorization_url、token_url 和 registration_url，但 issuer 字段留空。服务器初始工作正常，但大约一分钟后再次调用 GET /v1/mcp/server/oauth/{server_id}/authorize 时返回 400 错误，且持久错误直到管理员执行某些配置写入操作才会恢复。

报错原文

400 {"detail":"MCP server authorization url is not configured..."}

（Issue 标题原文：[Bug]: MCP OAuth: persisted discovered issuer flips servers into issuer-anchored mode; one failed metadata fetch then breaks /authorize until a config write）

原因分析

根本原因是四个行为交互导致的逻辑缺陷：

1. 自动持久化发现 issuer： MCPServerManager._persist_discovered_oauth_endpoints 在注册表构建后运行，将发现的 issuer 写入数据库行中 issuer 列为空的行。
2. 误将发现 issuer 视为管理员固定： 下一次构建时 _uses_issuer_anchor 将任何存在 issuer 的行视为管理员锚定，但并未保存该 issuer 是发现来源还是管理员明确设置的（issuer_is_anchored 仅存在于内存中），导致服务器无声切换至锚定模式。
3. 锚定模式丢弃存储的端点： 在锚定模式下 _endpoints_yield_to_issuer 会忽略数据库里存储的 authorization_url 等列，强制每次构建都通过 RFC 8414 元数据获取来确定端点。
4. 一次失败导致永久故障： 当该元数据获取失败（网络抖动、限流等），由于锚定模式下 _carry_forward_resolved_oauth_endpoints 会跳过锚定服务器，导致 authorization_url 为 None，且 reload_servers_from_database 的快速路径因 updated_at 未变化而不会重试，从而造成永久性故障。

此外，诊断困难点在于：列表端点 GET /v1/mcp/server 返回解析后的视图（显示 null），而单个服务器端点 GET /v1/mcp/server/{server_id} 仍显示数据库中的原值，容易误导管理员以为是字段被清空。

环境排查

• 确认 LiteLLM Proxy 版本（若已知，请升级包含 PR #34990 修复的版本）。
• 检查 GET /v1/mcp/server/{server_id} 返回的 issuer 字段是否被自动填充，以及 updated_at 是否在未管理员操作时发生变化。
• 查看数据库记录中 issuer 字段的值是否与用户指定的端点来源一致。

解决步骤

1. 临时恢复服务： 在未修复的版本中，可通过执行一次触发 updated_at 变更的操作（如重新创建服务器）强制触发重建，但可能再次重复此问题。也可手动删除该服务器并重新创建，但需注意同样会在下一次注册表构建时重新触发缺陷。
2. 升级 LiteLLM： 安装包含 PR #34990 修复的版本（例如等待新发布）。该修复包含两部分：
   • 将发现的 issuer 保存在独立的 credentials.discovered_issuer 字段中，并通过 _admin_pinned_issuer 区分管理员固定与发现来源，使发现 issuer 不再转入锚定模式。
   • 对于缺少必要端点的服务器，将免除快速路径缓存，从而在下一次正常重载时触发发现重试，自动恢复。
3. 验证修复： 升级后重新创建受影响的服务器
   

   参考来源

   BerriAI/litellm #34985

   

   AI 工具推荐

   想把多个 AI 模型放在一个入口？

   GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

   了解 GamsGo AI

   推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

   这个方案解决了吗？

   解决了还没有