[Bug]: WebDAV data source auto-sync only deletes files, fails to add or update files (manual sync also fails to update modified files)

该问题通常出现在 RAGFlow 使用 WebDAV 数据源并开启自动同步时,表现为新增/修改文件长期不同步、但删除可以同步。优先排查 WebDAV 服务器返回的 Last-Modified 时间与 RAGFlow 服务器时钟是否一致。报错原文核心为: [Bug]: WebDAV data sour

快速结论:该问题通常出现在 RAGFlow 使用 WebDAV 数据源并开启自动同步时,表现为新增/修改文件长期不同步、但删除可以同步。优先排查 WebDAV 服务器返回的 Last-Modified 时间与 RAGFlow 服务器时钟是否一致。报错原文核心为:[Bug]: WebDAV data source auto-sync only deletes files, fails to add or update files (manual sync also fails to update modified files)。

适用环境:RAGFlow v0.27.2(Docker Compose 部署,启用数据源同步守护进程 rag/svr/sync_data_source.py,ENABLE_DATASYNC=1);WebDAV 数据源走 HTTPS,刷新间隔 2 分钟、清理间隔 2 分钟、超时 1740 秒、已开启“同步删除文件”;运行环境为 DSM 7.2.2,4 vCPU / 32GB RAM。

最快修复方案:升级到包含 WebDAV 增量同步修复的 RAGFlow 版本(Issue 中对应 PR 已合并,维护者请求原报告者验证并关闭)。暂无确认可通过配置项单独规避该问题的一步修复方案。

注意事项:Issue 中提出的加宽增量窗口、连续 0 命中告警、文档说明时钟一致性等属于建议方案,是否已全部落地需以实际版本为准;在服务器 Last-Modified 存在固定偏移的情况下,旧版本仍可能静默漏同步。

问题场景

用户在 RAGFlow 中配置 WebDAV 数据源并关联知识库,开启自动同步(刷新/清理间隔均为 2 分钟)后,删除文件可自动同步到知识库,但新增文件不会自动出现,修改已有文件后知识库仍保留旧内容。手动点击“Sync/Restart”可以加入新文件,却仍无法更新被修改的文件。“Test connection”连接测试成功,说明 WebDAV 地址和凭据本身正确。同步任务每轮显示 DONE、0 docs、0 errors,没有明显报错。

报错原文

[Bug]: WebDAV data source auto-sync only deletes files, fails to add or update files (manual sync also fails to update modified files)

SYNC task reports DONE, 0 docs, 0 errors every cycle (completely silent).
new_docs_indexed=0

原因分析

根据 Issue 讨论,最可能的原因是增量同步窗口按 start < modified <= end 过滤文件:rag/svr/sync_data_source.py 调用 WebDAVConnector.poll_source(start, end),common/data_source/webdav_connector.py 中的 _list_files_recursive 使用上一轮任务时间作为水位线、当前轮执行时间作为上界。若 WebDAV 服务器返回的 Last-Modified 比 RAGFlow 服务器真实 UTC 时间慢一个固定偏移(评论中提到常见于时区配置错误,例如 8 小时),新增或修改文件的时间始终早于水位线,就无法进入增量窗口,导致每轮静默显示 0 docs。

删除之所以正常,是因为 PRUNE 使用全量快照比对,不做 mtime 过滤;手动同步之所以能加入新文件,是因为重建路径使用 1970 到当前时间的全窗口。修改文件在手动同步下仍不更新,属于同一时间窗口语义导致的问题表现。

环境排查

  • 确认 RAGFlow 版本是否为 v0.27.2 或可能包含该问题的版本,并确认部署方式与数据源同步守护进程是否启用(Issue 中为 Docker Compose、ENABLE_DATASYNC=1)。
  • 确认 WebDAV 数据源配置:刷新间隔、清理间隔、超时、是否开启“同步删除文件”。
  • 对比 WebDAV 服务器返回的 Last-Modified 与 RAGFlow 服务器系统时间/UTC 时间,检查是否存在固定偏移或时区错误。
  • 查看同步任务日志中每轮是否持续出现 DONE、new_docs_indexed=0,同时远端实际存在新增文件。
  • 确认“Test connection”结果,仅能证明连接和凭据可用,不能证明 mtime 窗口过滤正常。

解决步骤

  1. 先记录问题现象:在 WebDAV 数据源新增一个受支持的小文件(如 .txt/.md),等待超过刷新和清理间隔,观察知识库是否仍无该文件。
  2. 检查 WebDAV 服务端文件列表返回的 Last-Modified 时间,并与 RAGFlow 所在服务器时间做对比,确认是否存在固定偏移。
  3. 可优先尝试升级到包含该 WebDAV 增量同步修复的 RAGFlow 版本;Issue 中维护者确认修复 PR 已合并,但没有给出具体版本号,请以实际发布说明和代码变更为准。
  4. 升级后重新触发一次同步(必要时点击“Sync/Restart”),并同时验证新增文件、修改文件、删除文件三种场景。
  5. 如果仍需临时验证,可在时间戳正常的 WebDAV 服务端复现对照,排除存储端时钟问题,但不要用修改生产文件 mtime 作为长期方案。

验证方法

在 WebDAV 数据源中新增文件并等待超过刷新/清理间隔,确认知识库自动出现该文件;修改已同步文件并等待相同间隔,确认知识库内容更新;删除文件后确认知识库同步删除。同时检查同步日志不再只是每轮 DONE、0 docs,而是能反映实际新增或更新数量。

参考来源

infiniflow/ragflow #19955

GamsGo AI

AI 工具推荐

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

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

了解 GamsGo AI

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

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36045

发表回复

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