ewoooc/docs/memory/db_connection_pool_singleton_20260430.md

DB Connection Pool Singleton Hotfix (2026-04-30)

背景

/daily_sales 出現 PostgreSQL FATAL: sorry, too many clients already。根因不是單一查詢過重，而是多個 route 會在 request 內直接呼叫 DatabaseManager()，舊實作每次初始化都 create_engine()，導致同一個 worker process 內反覆建立新的 SQLAlchemy connection pool。

修正

database/manager.py 的 DatabaseManager 以 (DATABASE_TYPE, effective_db_path) 作為 key 快取 engine 與 Session factory。後續直接 DatabaseManager() 會共用同一組連線池，不再持續放大 PostgreSQL client 數。

維運提醒

• 若再次遇到 too many clients already，先檢查是否有新模組繞過 database.manager.get_db_manager() 或直接 create_engine()。
• 熱修後需重啟 momo-pro-system，讓舊 process 釋放既有連線池。
• 不需要重啟或重建 momo-db。