Mistral OCR unusable as a document parser: mis-registered as image2text (“Can’t find model”); still reproduces on v0.26.x

该报错因 Mistral OCR 模型被错误注册为 image2text 类别导致,实际它是一个云端 OCR 文档解析器。优先排查 RAGFlow 模型目录中的 “Mistral OCR” 模型类型是否被正确识别为 ocr 而非 image2text ,并确认是否已升级到包含 #17057 修复的版

快速结论:该报错因 Mistral OCR 模型被错误注册为 image2text 类别导致,实际它是一个云端 OCR 文档解析器。优先排查 RAGFlow 模型目录中的 “Mistral OCR” 模型类型是否被正确识别为 ocr 而非 image2text,并确认是否已升级到包含 #17057 修复的版本。

适用环境:RAGFlow v0.26.x(含 v0.26.4);Mistral API key;Mistral OCR 模型。

最快修复方案:升级到包含 PR #17057(commit 0833250)的 RAGFlow 版本,该 PR 已将 Mistral OCR 正确注册为专用文档解析器(OcrModel),并移除了其 image2text 的误注册。

注意事项:升级后,之前已在数据集中配置为 mistral-ocr-latest(旧 image2text 标签)的解析器,需要在数据集配置中重新选择新的 “Mistral OCR” 解析器,否则可能仍指向无效路径。

问题场景

用户在 RAGFlow 的数据集(dataset)配置中,将 PDF 解析器/布局识别器设置为模型目录中的 mistral-ocr-latest(被展示为 image2text 模型)。随后对任意 PDF 文件执行解析(Parse)操作时触发报错。

报错原文

AssertionError: Can't find model for <tenant_id>/image2text/mistral-ocr-latest

原因分析

问题根源为分类错误(category error):mistral-ocr-latest 是 Mistral 提供的专用文档 OCR 端点(POST /v1/ocr),并非视觉对话模型(image2text)。RAGFlow 的 conf/llm_factories.json 配置文件错误地将其标记为 image2text,导致系统在运行时将其路由至 CvModel 注册表去查找实现,而 CvModel 中并未提供 Mistral 的实现,故触发 Can't find model 断言错误。同时,系统也没有正确的 OcrModel 注册入口供其使用,导致此模型在 UI 上可选,但在运行时始终失败。

环境排查

  • RAGFlow 版本:v0.26.x(含 v0.26.4 及之前版本),此问题自 2025 年 3 月起已被多次报告。
  • Mistral API key 状态:确认 API key 有效且配额充足。
  • 数据集配置:检查具体数据集的“分块配置”(Chunking Config)中,PDF 解析器是否选择为 mistral-ocr-latest 且被归类为 image2text

解决步骤

  1. 更新 RAGFlow 版本:确保部署的 RAGFlow 已合并 PR #17057(commit 0833250)的代码。该提交已将 Mistral OCR 从 image2text 误注册中移除,并正确添加为 Mistral OCR 工厂下的专用 OcrModel 文档解析器。
  2. 重启服务:更新代码后,重启 RAGFlow 相关服务以使配置文件生效。
  3. 重新配置数据集解析器:进入问题数据集的配置界面,在 PDF 解析器下拉菜单中重新选择 Mistral OCR(而非旧的 mistral-ocr-latest 条目)。
  4. 重新执行解析:对目标 PDF 文件重新触发解析任务。

验证方法

在更新版本并重新配置后,对同一份 PDF 文件执行解析操作。如果解析成功完成,不再报 Can't find model 错误,且返回结构化 Markdown 内容(含表格),即表明问题已解决。

参考来源

<a

参考来源

infiniflow/ragflow #17056

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 15145

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注