[Question]: Models disappear after upgrading RAGFlow from v0.25.6 to v0.26.0

问题场景

用户将 RAGFlow 从 v0.25.6 升级到 v0.26.0 后，在 UI 的模型配置页面（Settings → Model Configuration）中发现之前添加的所有 LLM 嵌入/聊天模型消失，未进行手动删除操作。

报错原文

[Question]: Models disappear after upgrading RAGFlow from v0.25.6 to v0.26.0

原因分析

可能原因：升级时数据库 Schema 发生了变化（例如 tenant_model_provider、tenant_model_instance、tenant_model、model_id_config 等表结构变更），但自动迁移脚本因某些原因未被执行（如数据库连接配置错误、启动顺序问题、或已有数据库版本号未正确识别）。这导致旧模型数据仍在表中但无法被新版本代码正确读取或展示。

环境排查

• 确认数据库类型（已知支持 MySQL，其他数据库可能需调整迁移脚本参数）
• 检查启动日志中是否包含 “Running database migration” 相关条目
• 确认原有数据库卷（volume）在升级时是否被保留
• 确认部署方式（Docker Compose / 源码部署）及启动入口脚本是否正常运行
• 进入数据库直接查询相关表（如 tenant_model）检查数据是否物理存在

解决步骤

1. 停止 RAGFlow 服务。
2. 进入后端服务所在环境（Docker 容器内或源码部署的虚拟环境），确保已激活 Python 虚拟环境。
3. 确认配置文件路径（默认为 conf/service_conf.yaml），检查数据库连接参数是否正确。
4. 执行以下命令手动触发迁移：
   python tools/scripts/mysql_migration.py --stages tenant_model_provider,tenant_model_instance,tenant_model,model_id_config --config conf/service_conf.yaml --execute --database-version "v0.26.0" --mark-database-version-on-success
5. 观察命令输出，确认各阶段迁移成功。
6. 重启 RAGFlow 服务。

验证方法

重启后登录 UI，导航至模型配置页面，检查之前添加的模型是否恢复显示。如果模型仍不可见，建议直接连接数据库，查询 tenant_model_instance 等表确认数据是否已从旧版本迁移成功。

参考来源

infiniflow/ragflow #15972

AI 工具推荐

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

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

了解 GamsGo AI

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