GitHub Repo
Open WebUIの議論でSQLite接続プールのリスクが明らかに、デフォルト容量がファイルオープン上限を超える可能性
Open WebUIコミュニティは11月14日、長時間稼働するSQLite環境でファイルディスクリプターが枯渇し、モデルサービスに接続できなくなる事例を報告した。プロジェクトメンバーは接続リークを再現できなかった一方、デフォルトの接続プールが満杯になると、システムのファイルオープン数のソフト上限である1024を超える可能性があると指摘した。

Open WebUIで11月14日に行われた障害に関する議論から、自前で運用するAIインターフェースで見落とされやすい容量上の問題が明らかになった。データベース接続プールの容量と、OSのファイルディスクリプター上限が一致していない可能性がある。報告者はv0.13.3をネイティブ環境にデフォルトのSQLite設定でインストールし、約2日半後にToo many open filesエラーに遭遇。その結果、モデルサービスへの外部HTTP呼び出しも失敗し、再起動後に復旧した。障害に関する議論
報告者は当初、返信のキャンセル時に発生する接続リークが原因だと考えていた。しかし、プロジェクトメンバーのClassic298によると、現在の開発ブランチでチャットを1,200回、ランダムなキャンセル操作を2,000回テストしても再現しなかった。既存のキャンセル処理では接続をロールバックして接続プールに返却するため、新たなリーク不具合があると断定するには証拠が不十分だとしている。このIssueは対応予定なしとしてクローズされた。テストと回答
より明確なリスクは容量設定にある。公式ドキュメントによると、SQLiteでDATABASE_POOL_SIZEを未設定にするか0に設定した場合でも、接続数は512となり、さらに10接続のオーバーフローが許容される。この場合、0にしてもプーリングは無効にならない。プロジェクトメンバーの説明では、各接続がデータベースファイルとWALファイルのファイルディスクリプターを保持するため、プールが満杯になると1024のソフト上限を超える可能性がある。データベースのリソース不足がモデル接続の障害として現れることがあり、原因の特定が難しくなる。接続プールの設定
エンジニアリングチームは、まず実際の同時実行数に合わせて接続プールを縮小し、そのうえでサービスのファイルオープン上限を確認できる。議論では、調整例としてDATABASE_POOL_SIZE=32が提案された。公式のコンテナ向けドキュメントには、ファイルディスクリプターの上限として65536が記載されている。プロセスごとに独立した接続プールがあるため、workerやレプリカを増やす場合は、必要なリソースを改めて計算する必要がある。デプロイ時のリソース設定、プロセスと接続プールの関係
今後は、接続プールを縮小した後もファイルディスクリプター数が増え続けるかを観察し、操作手順とサーバーログを保存しておくとよい。今回の議論で示されたのは、すぐに確認できるデプロイ上のリスクと緩和策であり、長時間稼働するすべてのインスタンスに同じ不具合があると証明されたわけではない。