• Ошибка FATAL: sorry, too many clients already при всплеске пользовательских сессий.
• Сотни процессов postgres: client backend утилизируют всю оперативную память сервера.
• Ошибки PREPARE statement already exists или сбои временных таблиц при использовании режима Transaction Pooling.

1. Конфигурация /etc/pgbouncer/pgbouncer.ini

[databases]
* = host=127.0.0.1 port=5432 auth_user=postgres

[pgbouncer]
logfile = /var/log/postgresql/pgbouncer.log
pidfile = /var/run/postgresql/pgbouncer.pid
listen_addr = 0.0.0.0
listen_port = 6432
auth_type = scram-sha-256
auth_file = /etc/pgbouncer/userlist.txt

# --- Выбор режима пулинга ---
# session: полное соответствие поведению прямого подключения (рекомендовано для 1С)
# transaction: максимальная плотность соединений (требует отключения server-side prepared statements)
pool_mode = session

# --- Лимиты соединений ---
max_client_conn = 2000        # Максимум входящих клиентских подключений к PgBouncer
default_pool_size = 50        # Лимит реальных бэкенд-соединений к PostgreSQL на одну базу
min_pool_size = 10
reserve_pool_size = 5
max_db_connections = 150      # Суммарный лимит соединений к конкретной БД

2. Создание файла пользователей /etc/pgbouncer/userlist.txt

"postgres" "SCRAM-SHA-256$4096:5x...=="
"enterprise_user" "SCRAM-SHA-256$4096:a8...=="

3. Диагностика пулов и очередей через административную консоль

psql -p 6432 -U postgres -d pgbouncer

-- Просмотр очередей клиентов и свободных бэкенд-серверов
SHOW POOLS;

-- Статистика соединений и трафика
SHOW STATS;

-- Просмотр активных клиентских сокетов
SHOW CLIENTS;