SupabaseのDBコネクションが枯渇する問題の解決方法

はじめに

Supabase をバックエンドサーバーから利用する場合、Supabase SDKを使わずにSession Pooler（Supavisor） を使った接続が望ましいです。

Session Pooler 自体の概要や、なぜ Supabase ではこれを使うべきかについては、別の記事で詳しくまとめています。

ただし、そのときに デフォルト設定のままでは、想像以上に早くコネクションが枯渇してしまいます

本記事では、

を、Session Pooler の仕組みを踏まえながら解説していきます。

結論としてやることはシンプルで、デフォルトの設定値を適切に引き上げるだけです。
しかし「なぜそれで安全なのか」「どこまで増やしてよいのか」を理解せずに設定を変えるのは危険です。

この記事では、単なる設定手順だけでなく、
安心して本番に投入できる理由まで含めて説明することを目的としています。

まず前提として、Supabase の Session Pooler（Supavisor）には デフォルトのプール設定 が存在します。

Database max connections：60（無料プラン）

Pool Sizeの下のMax Client ConnectionsはClientとSession Poolerの間のコネクション数です。
Pool SizeはSession PoolerとDatabase間のコネクションの数です。その最大値は大きすぎる値を設定したときのエラー文から確認できます。

つまり、デフォルトでは DB が許容する最大接続数のうち 25% しか使っていません。

これでは、

など短時間に DB アクセスが集中したときにすぐに枯渇してしまいます。

Supabase の公式ドキュメントでも推奨されている方法として、Pool Size を引き上げることで解決できます。

Supabase DashboardでDatabase -> Settingsから先ほどの画像のページにアクセスして変更できます。

Data API (Supabase SDK) を使用する場合
- 推奨 Pool Size：40%（24 本）
- SDK と同時に DB に接続することを考慮して安全に抑えます。
Data API を使用しない場合
- 推奨 Pool Size：80%（48 本）
- DB の最大接続数に対して余裕を持たせつつ、ほぼフルに活用可能です。

Data APIとはSupabaseがデフォルトで提供しているデータ取得のためのAPIです。Supabase SDKも内部的にこれを使用しています。

Supabase の設計思想を理解すると、Pool Size の設定の意図が見えてきます。

Supabase は フロントエンドから直接データを取得することを前提 に設計されています。

つまり、通常のアプリ利用では DB への直接接続は少なくても十分 という前提があります。

DB の max_connections（無料プランでは 60 本）は、単にユーザーアプリの接続だけでなく、以下の用途も含まれます：

そのため、デフォルト設定の Pool Size = 15 は「内部処理を含めて安全に収まる値」として保守的に設定されています。

デフォルトの 15 本は、Data API を前提とした設計上の保守的な値 であり、実運用や並列処理が多い環境では明らかに余裕が足りません。