快速结论:这个报错通常出现在 Open WebUI 开启 DATABASE_ENABLE_SESSION_SHARING=true、并通过 PgBouncer(transaction mode)访问 PostgreSQL 的场景:读事务在响应发送前一直不结束,请求在持有第一个连接的同时又去申请第二个连接,连接池被逐步占满后互相等待。优先排查连接池容量、PgBouncer 等待超时,以及会话共享相关的读事务释放逻辑。
适用环境:Open WebUI v0.13.3 及 dev 分支 782f4b7;Docker 安装;PostgreSQL + PgBouncer(transaction mode);开启 DATABASE_ENABLE_SESSION_SHARING=true。Issue 未见具体的 Python、CUDA、显卡版本信息。
最快修复方案:暂无确认的一步修复方案。报告中给出了参考补丁(commit read-only transactions when a shared-session helper finishes),但该补丁只是 Issue 里的参考实现,尚未在讨论中确认合入或验证。
注意事项:直接调大连接池只能拖延问题,不能消除“同一请求持有第一连接再等第二连接”的互锁;同时需注意 PgBouncer transaction mode 与 DATABASE_ENABLE_SESSION_SHARING 组合带来的事务生命周期问题。
问题场景
用户在 Docker 中运行 Open WebUI,数据库为 PostgreSQL,前面加 PgBouncer(transaction mode)。开启会话共享后,访问聊天列表 GET /api/v1/chats/?page=1 或收件箱计数 GET /api/v1/notifications/inbox/count 会一直挂起,直到 PgBouncer 的 query_wait_timeout 才返回。生产环境中出现 5 个副本全部受影响、持续 22 分钟的情况。
复现时把数据库连接压到极小:default_pool_size=1、max_db_connections=1。此时唯一一条服务端连接处于 idle in transaction,它正持有该请求自己的第一条查询(SELECT … FROM chat WHERE chat.user_id = …),而同一请求随后又要申请第二条连接,于是互相卡死。
报错原文
QueuePool limit of size 5 overflow 10 reached, connection timed out, timeout 30.00
sv_active=12
cl_waiting 56–63
原因分析
最可能的原因是会话共享下读事务的生命周期过长。在共享 session 上,第一条读查询会开启一个事务,该事务一直保持到响应发送完毕。而两个接口在持有该事务的同时又打开第二个 session:
add_active_state_to_chat_list调用ChatMessages.get_chat_ids_with_pending_approval();visible_clause调用Config.get_many()。
于是一个请求占用第一条连接后又等待第二条连接,而第二条连接正被其他同样卡住的请求占着,形成连接池级联耗尽。PgBouncer transaction mode 不会长期绑定服务端连接,但这并不能解决“事务未结束”本身的问题,因此表现为等待直到超时。
环境排查
- 确认 Open WebUI 版本是否为 v0.13.3 或
dev782f4b7,是否仍能复现。 - 确认
DATABASE_ENABLE_SESSION_SHARING是否被显式设为true;关闭该项后接口是否恢复正常(Issue 中关闭后耗时约 0.03 秒)。 - 确认是否通过 PgBouncer 连接,且其
pool_mode为 transaction。 - 检查连接池配置:
DATABASE_POOL_SIZE、DATABASE_POOL_TIMEOUT对应报错中的size 5 overflow 10与timeout 30.00。 - 检查 PgBouncer 配置:
default_pool_size、max_db_connections、query_wait_timeout。 - 在数据库侧查看是否存在长时间
idle in transaction的连接,以及 PgBouncer 的sv_active、cl_waiting指标。
解决步骤
- 先用对照实验确认问题与开关相关:关闭
DATABASE_ENABLE_SESSION_SHARING,再次请求上述两个接口,确认是否立即返回。若恢复,则属于本 Issue 描述的事务生命周期问题。 - 若必须保留 PgBouncer transaction mode 且需要会话共享,可优先尝试 Issue 中给出的参考补丁方向:在共享 session 的只读 helper 结束时提交其只读事务,写操作、
FOR UPDATE和 savepoint 保持原事务不提交。该补丁为参考实现,非官方确认修复。 - 临时缓解可适当放大连接池(
DATABASE_POOL_SIZE)与 PgBouncer 的default_pool_size,但这只是延迟耗尽时间,不能打破“请求持有第一连接又等第二连接”的循环。 - 若无法立即修改代码,评估临时关闭
DATABASE_ENABLE_SESSION_SHARING是否可接受,以换取接口可用性。
验证方法
在 default_pool_size=1、max_db_connections=1 的限制下,重新登录并创建一个聊天,然后请求 GET /api/v1/chats/?page=1 与 GET /api/v1/notifications/inbox/count:若两者能在毫秒级返回,且数据库中没有长期处于 idle in transaction 的连接、PgBouncer 的 cl_waiting 不再堆积,可认为问题已解决。生产环境还应观察连接池是否仍出现 QueuePool limit ... reached。
参考来源
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。

![issue: [regression] [dev] a folder icon picked on the folder page does not show in the sidebar until a reload](https://www.chat-gpts.plus/wp-content/uploads/2026/11/34374-752736eb-768x403.jpg)
