[Bug]: LiteLLM_MCPServerTable.source_url` does not exist in the current database.

快速结论：此报错通常出现在运行 LiteLLM 代理并通过 Admin UI 添加 MCP 服务器时，因数据库表 LiteLLM_MCPServerTable 缺少 source_url 列而导致。优先排查 LiteLLM 数据库版本是否过旧，或尝试手动添加该列作为临时方案。

问题场景

用户在 LiteLLM 代理的 Admin UI 中添加 MCP 服务器（MCP Server）时触发该错误。报错表明数据库模式（schema）与代码预期不匹配，代理返回 HTTP 500 错误。相关环境包括使用 Docker 镜像 docker.litellm.ai/berriai/litellm:main-stable（v1.82.3）及 ghcr.io/berriai/litellm-database 的用户。

报错原文

prisma.errors.DataError: The column `LiteLLM_MCPServerTable.source_url` does not exist in the current database.

database-1 | 2026-03-18 14:04:28.774 UTC [77] ERROR: column LiteLLM_MCPServerTable.source_url does not exist at character 1714

原因分析

可能原因：数据库模式未及时更新，LiteLLM_MCPServerTable 中缺少 source_url 列。该列是通过数据库迁移新增的，但部分用户的数据库版本早于迁移提交，导致代理查询时触发 Prisma 的 DataError。根据 Issue 讨论，该问题与模式同步（schema_sync）操作可能意外删除该列有关，已有补丁防止未来出现此问题。

环境排查

确认 LiteLLM 代理版本（例如 v1.82.3 或更早版本可能导致问题）。
确认 LiteLLM 数据库镜像版本（例如 ghcr.io/berriai/litellm-database）。
检查数据库是否运行在 Docker Compose 环境中。
确认是否使用 Vercel AI SDK（可能不直接影响此错误，但可能引发其他连接问题）。

解决步骤

推荐方案：升级至包含修复的版本
- 将 LiteLLM 数据库镜像升级至 ghcr.io/berriai/litellm-database:v1.83.8-nightly 或更新版本。
- 如果使用 Docker Compose，修改 docker-compose.yml 中的 image 字段，然后重新启动服务。
- LiteLLM 团队确认该修复在 v1.83.8-nightly 及之后版本中可用。
临时方案：手动添加数据库列
- 登录数据库（例如 PostgreSQL 管理界面），执行以下 SQL 命令：
```
ALTER TABLE LiteLLM_MCPServerTable ADD COLUMN source_url text;
```
- 重启 LiteLLM 代理以使 Prisma 识别该列。
- 注意：部分用户反馈仅添加列后仍无法使用 MCP 服务器功能，可能需要同时升级代理代码。
确认迁移已应用
- 重启代理后，检查数据库日志中是否有迁移相关输出。
- 验证相关迁移（如 #24078 和 #24705）已生效。

验证方法

再次通过 Admin UI 添加 MCP 服务器，若不再出现 HTTP 500 错误且 DataError 报错消失，则表示问题已解决。建议同时测试 MCP 工具调用功能（如访问深度维基工具），确认一切正常运行。

参考来源

BerriAI/litellm #24013

AI 工具推荐

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

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

了解 GamsGo AI

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

[Bug]: LiteLLM_MCPServerTable.source_url` does not exist in the current database.