返回首頁

GitHub Repo

Open WebUI 修補嵌入批次設定空值,避免檔案上傳後處理失敗

Open WebUI 於 10 月 28 日合併修補,解決清空嵌入批次大小後,設定顯示正常卻無法處理檔案的問題。修補已進入 dev 分支,既有空值設定仍須重新儲存才能修復。

NASA · Public domain · Image source
zh-Hant

Open WebUI 於 10 月 28 日將 PR #33288 合併至 dev 分支,修補文件設定中的空值處理缺陷:管理員清空 Embedding Batch Size 並儲存後,後續上傳的檔案可能無法完成處理。這項變更直接影響文件匯入與檢索增強生成(RAG)的前置流程。修補紀錄

回報者在 Linux 開發版本中,以 Ollama 嵌入引擎重現問題,也表示 OpenAI 相容引擎的測試實例出現相同結果。觸發方式是在管理介面的 Documents 頁面清空批次大小後儲存;系統會顯示成功,重新載入頁面甚至又顯示數字 1,但附加小型文字檔時仍出現 NoneType 無法作為整數的錯誤。介面上的預設顯示因此掩蓋了實際設定狀態。問題回報

官方文件說明,這個參數控制外部嵌入服務每次 API 請求接收的文字區塊數,預設為 1,適用於 Ollama、OpenAI 與 Azure OpenAI,不適用於預設的 SentenceTransformers 引擎。增加批次可以減少請求次數,但必須先確認服務與模型支援多筆輸入;它也與控制同時請求數量的並行參數不同。設定文件

修補說明將原因定位在設定寫入邊界:空白欄位送出 null,後端直接保存,嵌入函式卻需要數字。新版在保存時把空值轉為 1。作者表示,修補後相同文字檔可正常處理,並回報既有文件與檢索相關測試通過;這些驗證仍屬貢獻者提供的結果。修補與驗證

對維運人員而言,這個案例顯示,排查文件匯入失敗時,也應檢查設定是否真的寫入有效數值。已受影響的實例可填入有效批次大小並重新儲存,再上傳小檔確認恢復。修補目前可確認已合併開發分支,尚不能據此認定穩定版已包含;已有空值的實例,依修補說明仍需再次儲存 Documents 設定。後續處理說明

來源

  1. Open WebUI:清空 Embedding Batch Size 導致檔案處理失敗
  2. Open WebUI PR #33288:將空白嵌入批次大小正規化為預設值
  3. Open WebUI 環境變數設定文件