返回首頁

GitHub Repo

Open WebUI 討論釐清 SQLite 連線池風險,預設容量可能超過檔案開啟上限

Open WebUI 社群於 11 月 14 日回報,長時間運行的 SQLite 部署因檔案描述符耗盡而無法連接模型服務。專案成員未重現連線洩漏,但指出預設連線池滿載時,可能超過系統的 1024 個檔案開啟軟限制。

NASA · Public domain · Image source
zh-Hant

Open WebUI 在 11 月 14 日的一則故障討論中,揭露自架 AI 介面容易忽略的容量問題:資料庫連線池與作業系統檔案描述符上限可能互不匹配。回報者使用 v0.13.3、原生安裝與預設 SQLite,約兩天半後遇到 Too many open files,連帶使模型服務的對外 HTTP 呼叫失敗,重啟後才恢復。故障討論

回報最初將原因歸於取消回覆時的連線洩漏,但專案成員 Classic298 表示,在目前開發分支測試 1,200 輪聊天及 2,000 次隨機取消儲存,均未重現。他指出,既有取消處理會將連線回滾並歸還連線池,因此目前證據不足以確認新的洩漏缺陷;議題已以不計畫處理關閉。測試與回覆

較明確的風險在容量設定。官方文件記載,SQLite 的 DATABASE_POOL_SIZE 未設定或設為零時,仍採用 512 個連線,另允許 10 個溢位連線;零值在此並不會停用池化。專案成員解釋,每個連線持有資料庫與 WAL 檔案描述符,滿載配置便可能突破 1024 的軟限制。這使資料庫資源壓力有機會表現為模型連線故障,增加排查難度。連線池設定

工程團隊可先依實際併發量縮小連線池,再核對服務的檔案開啟上限。討論建議以 DATABASE_POOL_SIZE=32 作為調整例子;官方容器文件則列出 65536 的檔案描述符限制。每個程序都有獨立連線池,增加 worker 或副本時,也須重新計算資源需求。部署資源設定、程序與連線池關係

後續應觀察縮小連線池後,描述符數量是否仍持續上升,並保留操作步驟與伺服器日誌。這次討論提供的是可立即檢查的部署風險與緩解方式,尚不能證明所有長時間運行的實例都存在相同缺陷。

來源

  1. Open WebUI issue #34417:SQLite instance runs out of open files after days of use
  2. Open WebUI 環境變數文件:DATABASE_POOL_SIZE
  3. Open WebUI 效能文件:Container Resource Limits