[Bug]: upgrade from 0.24.0 to 0.25.0

快速结论：该报错发生在从 RAGFlow 0.24.0 升级到 0.25.0 后，之前通过 LM Studio 等外部工具配置的大语言模型和元数据全部丢失，报错信息显示 “Tenant Model with name xxx not found”。优先排查数据库模式迁移是否成功执行。

问题场景

用户在 Windows 11 + Docker Desktop 4.69 + NVIDIA 5090D 环境下，将 RAGFlow 从 0.24.0 升级到 0.25.0 后，所有通过 LM Studio 连接的大语言模型（如 qwen3.5-9b）均无法调用，重新添加也无效。日志中反复出现 Tenant Model with name xxx and type chat not found 错误。

报错原文

[ERROR][Exception]: Tenant Model with name qwen3.5-9b@LM-Studio and type chat not found

原因分析

这是 v0.25.0 版本引入的重大数据库模式重构导致的已知问题。该版本将旧有的 tenant_llm 表替换为三个新表：tenant_model_provider、tenant_model_instance 和 tenant_model。升级过程中数据库迁移脚本未正确执行，导致之前配置的模型配置未能迁移到新表，从而报 LookupError。

环境排查

确认 RAGFlow 镜像版本是否为 0.25.0
确认 MySQL 数据库连接凭据（host、port、user、password、database）
确认是否存在备份的旧版本数据库
检查 docker-compose.yml 中 MYSQL_HOST、MYSQL_PORT 等环境变量是否正确

解决步骤

先执行模拟（dry-run）验证：在 RAGFlow 容器或宿主机上运行以下命令，检查迁移脚本是否能识别旧表数据：

python tools/scripts/mysql_migration.py \
  --stages tenant_model_provider,tenant_model_instance,tenant_model \
  --host <mysql_host> --port <mysql_port> --user <user> --password <password> --database <database>

执行实际迁移：如果 dry-run 没有报错，执行：

python tools/scripts/mysql_migration.py \
  --stages tenant_model_provider,tenant_model_instance,tenant_model \
  --host <mysql_host> --port <mysql_port> --user <user> --password <password> --database <database> \
  --execute

如果迁移脚本无法恢复模型：通过 RAGFlow UI 的 Model Providers 页面重新注册模型，然后在知识库中重新关联这些模型。
注意 Qwen3.5 模型名称问题：如果模型名称包含 “qwen3″（如 qwen3.5-9b），RAGFlow 会将其视为推理模型并自动添加 enable_thinking 参数，而 LM Studio 不支持该参数。可优先尝试将 LM Studio 中的模型重命名为不含 “qwen3” 的名称（例如 qw35-9b）来规避此问题。

验证方法

完成迁移步骤后，重启 RAGFlow 服务，进入模型管理页面检查之前配置的 LM Studio 模型是否已恢复显示并可正常调用。如果迁移脚本失败，则需重新注册模型并确认知识库能正常使用新模型进行问答。

参考来源

infiniflow/ragflow #14307

AI 工具推荐

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

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

了解 GamsGo AI

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

[Bug]: upgrade from 0.24.0 to 0.25.0