[Question]: model verification attempts failed: mineru no such method

问题场景

用户在 Docker Compose 部署的 RAGFlow（infiniflow/ragflow:v1.0.0-rc1）中添加自托管 MinerU 模型，填写 MinerU 服务地址后执行模型验证，验证持续失败。用户同时确认目标服务的 /openapi.json 可以正常访问（curl http://200.0.0.1:32000/openapi.json 返回 MinerU API 的 OpenAPI 文档，版本为 1.0.0），说明服务本身可达，问题不在网络连通性。

用户还反馈：把地址写成 https://mineru.net/api/v4/extract/task 时也出现相同提示，说明该报错并非只出现在某一个自托管地址上。

报错原文

model verification attempts failed: mineru no such method

原因分析

最可能的原因是 RAGFlow 的 MinerU 模型校验逻辑与当时的 MinerU 服务接口不匹配：RAGFlow 在验证阶段调用的某个接口方法在当前 MinerU 服务中不存在，因此返回 “no such method”。

用户已确认 /openapi.json 可访问，且其中列出了 /v1/health、/v1/models、/v1/models/{model} 等路径，这表明“服务不可达”不是主因；更可能是 RAGFlow v1.0.0-rc1 对 MinerU 的调用方式与该版本 MinerU 提供的接口不一致。

维护者在 Issue 中确认此问题已在 #20459 中修复，并在 #20721 中进一步改进，说明根因位于 RAGFlow 侧的 MinerU 接入/校验实现，而非用户本地网络或 MinerU 服务启动失败。

环境排查

• 确认当前 RAGFlow 镜像版本：Issue 中为 infiniflow/ragflow:v1.0.0-rc1，该版本存在此问题。
• 确认 MinerU 服务版本：Issue 中用户反馈为 mineru-4 / MinerU 4.0.9。
• 确认 MinerU 服务地址可从 RAGFlow 容器内访问，且 /openapi.json 返回正常；Issue 中该检查已通过。
• 确认升级后的 RAGFlow 版本说明或发布记录中包含对 MinerU 接入的修复（对应 #20459、#20721）。
• Issue 未提供 Python、CUDA、PyTorch、显卡、其它节点或依赖版本信息，这些项目无需作为本次排错的前置条件。

解决步骤

1. 记录当前 RAGFlow 部署方式与镜像标签，Issue 中为 Docker Compose 项目 ragflow2 和镜像 infiniflow/ragflow:v1.0.0-rc1。
2. 将 RAGFlow 升级到包含 #20459、#20721 修复的最新版本。由于 Issue 未给出具体版本号，请以官方发布的最新可用版本为准，不要继续使用 v1.0.0-rc1 做 MinerU 模型验证。
3. 使用升级后的镜像重建并启动 RAGFlow 服务，例如沿用原有 Compose 项目重新拉起容器；具体命令以你的 Compose 文件为准。
4. 回到 RAGFlow 的模型添加页面，重新填写自托管 MinerU 的服务地址并再次执行验证。
5. 若升级后仍失败，保留 RAGFlow 版本、MinerU 版本、服务地址和完整报错信息，回到原 Issue 反馈以便重新打开处理。

验证方法

在升级后的 RAGFlow 中添加 MinerU 自托管模型并点击验证，不再出现 model verification attempts failed: mineru no such method，且模型可以正常保存/用于解析任务，即可认为问题已解决。建议同时确认 MinerU 的 /openapi.json 仍可访问，以排除服务地址变更带来的新问题。

参考来源

infiniflow/ragflow #20407（含维护者关于 #20459、#20721 已合并到 main 分支的说明）

AI 工具推荐

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

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

了解 GamsGo AI

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