[Question]: Unable to import PDF files

问题场景

用户部署 RAGFlow Docker 版 20.2 后，在首次创建知识库时遇到三类问题：PDF 文件无法导入；知识库刚创建时能导入除 PDF 外的其他类型文件，但创建后无法打开该知识库；在选择大模型时，下拉列表无法滚动查看后方的模型。

报错原文

[Question]: Unable to import PDF files

原因分析

可能原因分析：

PDF 导入失败和知识库无法打开：Issue 讨论链未提供具体日志，无法确定根因。可能原因包括 Docker 容器内部文件权限问题、PDF 解析服务（如 DeepDoc）未正常启动、知识库创建后索引服务崩溃，或容器内存/磁盘空间不足导致写入失败。

模型列表无法滚动：已确认为 UI 实现问题。模型选择下拉框和弹出组件设置了固定高度和 overflow 属性，当模型数量较多时，列表可见区域受限，导致无法滚动查看全部模型。

环境排查

• 确认 Docker 容器运行状态：docker ps 检查 RAGFlow 相关容器是否全部正常运行。
• 查看容器日志：docker logs <ragflow容器名>，重点排查 PDF 解析、知识库创建相关的错误输出。
• 确认 Docker 版本及 RAGFlow 镜像版本是否为 20.2。
• 检查宿主机磁盘剩余空间，确认是否满足 Docker 卷写入需求。
• 确认浏览器版本，模型列表滚动问题可能与浏览器对固定高度组件的渲染有关。

解决步骤

1. 先排查 PDF 导入问题：进入 RAGFlow 容器终端（docker exec -it <容器名> bash），检查 PDF 解析相关服务（如 DeepDoc）是否正常运行。
2. 查看知识库创建日志：在容器日志中搜索知识库创建相关的错误关键字（如 “create kb failed”、”permission denied”、”out of memory”）。
3. 验证文件权限：检查 Docker 挂载卷（如 ~/ragflow/data）的属主和权限，确保容器用户有写入权限。
4. 重启 RAGFlow 服务：执行 docker-compose restart（或对应的重启命令），待服务完全启动后重试导入 PDF。
5. 尝试更换文件格式测试：如问题仅限 PDF，尝试导入同一份文件转换后的 DOCX 格式，判断是否为 PDF 解析链路问题。
6. 临时解决模型列表滚动问题（可优先尝试）：在浏览器中缩小页面比例（如 Ctrl + 减号），扩大可视区域后再进行模型选择。
7. 使用模型筛选功能：官方后续更新已加入筛选选项，可按模型类型（All、Text-only、Multimodal）缩小列表范围，减少滚动需求。

验证方法

PDF 导入问题：成功上传并解析 PDF 文件后，知识库中出现可预览的文档块（Chunk），且 QA 对话能引用该文档内容。

知识库无法打开问题：点击知识库名称后能正常进入文档列表页面，不再出现空白或报错。

模型列表滚动问题：缩小浏览器页面比例后，下拉列表中所有模型均可见，可正常选择目标模型。

参考来源

infiniflow/ragflow #9586

AI 工具推荐

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

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

了解 GamsGo AI

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