GitHub Repo
Open WebUI 社群回報 Qdrant 寫入競態,知識庫可能顯示完成卻缺少文件片段
10 月 6 日的 Open WebUI 社群案例指出,Qdrant 尚未完成批次寫入時,知識庫流程可能提前讀取,留下不完整的文件副本。回報附有版本、日誌與核對方法,但尚無維護者確認或已合併修補。

Open WebUI 的文件匯入流程出現一項值得 RAG 工程師留意的完整性回報。10 月 6 日建立的議題指出,使用 Qdrant 後端時,文件可能已顯示 completed、API 也回傳成功,知識庫卻只收到部分片段。回報者在 v0.11.4 實際觀察到問題,另以程式碼閱讀確認當時開發分支保留相同路徑,未執行開發版重現。社群回報
問題涉及兩階段資料搬移:系統先把片段寫入文件集合,再讀回並放進知識庫。回報者指出,呼叫 upload_points 時未指定等待參數,沿用每批 64 點、wait=False 的預設值;後續流程可能在全部批次套用前開始讀取。其日誌案例中,文件有 86 個片段,讀回時卻只取得 64 個。流程與日誌
Qdrant 官方文件確認這項 API 語意:wait=false 回應代表收到請求,資料仍可能在背景處理,不能據此保證立即可讀。需要操作完成後再繼續的應用,可使用 wait=true。這支持回報提出的競態機制,但並未獨立驗證 Open WebUI 的實際缺陷。Qdrant 文件
對 RAG 而言,這類缺漏可能讓檢索階段根本找不到部分證據;這是依資料流程推導的風險,目前沒有回答品質評測。工程師應把文件處理狀態與知識庫內容完整性分開驗證,尤其是更新文件後立即同步、或批次匯入的情境。
回報者建議等待寫入完成,並核對來源與知識庫副本的片段內容;但重新切分可能改變片段數,不能只憑數量差異判定遺失。截至查核時,議題仍開啟,未列出修補 PR。後續需確認修補是否涵蓋兩種 Qdrant 客戶端,以及等待完成對匯入延遲的影響。處理建議與狀態