Dify集成MinerU插件解析PDF失败排查
我在本地docker安装了minerU,在dify中也集成了minerU插件。但是测试pdf解析,返回:
Failed to parse file. result: {"detail":"Not Found"}
你在Dify中测试MinerU插件时遇到 {"detail":"Not Found"} 错误,这通常是因为Dify无法正确访问你本地部署的MinerU服务。问题根源往往出在网络连接配置上。
下面是一个排查流程图,可以帮助你系统地定位问题:


🔧 逐步排查与解决
请按照以下步骤逐一检查和修正配置:
1. 检查 MinerU 服务的 Base URL 配置
在 Dify 的 MinerU 插件配置中,Base URL 必须填写你运行 MinerU 服务的宿主机在局域网内的IP地址,而不是 localhost 或 127.0.0.1。
原因:当 Dify 服务(通常也运行在Docker容器中)尝试访问配置为
localhost的 MinerU 服务时,它访问的是 Dify 自己的容器内部,而不是宿主机上的 MinerU 服务。如何获取本机IP:
Windows:打开命令提示符 (
cmd),输入ipconfig,查找"IPv4 地址"。macOS:打开终端,输入
ipconfig getifaddr en0(无线网络) 或ipconfig getifaddr en1(有线网络)。Linux:打开终端,输入
ip addr或hostname -I。正确配置示例:
MinerU服务的Base URL:
http://192.168.1.100:8888(将192.168.1.100替换为你的实际IP,端口确保是MinerU服务暴露的端口)。令牌:留空(本地部署通常不需要)。
服务类型:选择"本地部署"。
2. 确认 MinerU 容器正常运行
确保你的 MinerU Docker 容器正在运行,并且端口映射正确。
检查容器状态:
docker ps
查看容器日志:
docker logs <你的mineru容器名或ID>
确认端口映射:在运行 MinerU 容器的命令中,确保包含了端口映射,例如
-p 8888:8888。你的 Docker 运行命令应类似于:docker run -p 8888:8888 ...
原创不易,完成人机校验,阅读全文