[Dify] 知识库上传失败或无响应的排查手册

在 Dify 中，知识库是构建 AI 应用的“知识地基”。
但在上传文档的过程中，许多用户会遇到这样的情况：

• 上传文件长时间卡在“处理中”

• 上传后页面无响应或失败提示

• 文件上传成功但知识内容为空

• 上传一半后系统报错

这些问题往往不是 Dify 本身“坏了”，而是由 文件格式、编码、环境配置或网络 等原因引起的。

本文将手把手教你如何排查这些问题，让你快速恢复知识库正常上传。

---

一、先了解上传的基本规则

Dify 当前知识库上传规则（2025 年版本）如下：

限制项	说明
单次上传数量	最多 5 个文件
单个文件大小	≤ 15 MB
支持格式	TXT、MD、MDX、MARKDO