PostgreSQL / 系统课时
设计连接扩容门禁
设计连接扩容门禁
本课解决“应用一扩容,数据库连接就突然打满”的治理问题。核心做法是把数据库最大连接预算、应用副本数、单实例连接池上限和运行中连接水位放进同一套发布门禁,让扩容同时通过静态容量与实时余量检查。
学习目标
- 能计算副本数变化后可能产生的连接总量,并区分理论上限与实时水位
- 能为连接扩容建立可执行的预算、阈值和拒绝条件
- 能用发布前检查阻止连接池配置突破 PostgreSQL 容量,或在临界水位继续扩容
先把连接预算算清楚
不要直接从“每个实例连接池设多少”开始设计,而应先确定 PostgreSQL 能给业务保留多少连接。设数据库允许业务使用的连接预算为 ,应用副本数为 ,单实例连接池上限为 ,则扩容后的理论连接上限为 。
更稳妥的门禁还应预留管理、运维、迁移和其他工作负载所需连接,因此业务池不能直接吃满 max_connections。例如数据库配置为 200 个连接,预留 40 个后,业务静态预算最多为 160;但这只是配置层上限,不能单独代表当前是否具备扩容余量,还必须检查运行中连接水位。

把门禁拆成静态预算与实时水位
假设 max_connections 为 200,计划预留 40 个连接给超级用户、运维和其他服务,则业务预算最多为 160。当前有 8 个应用副本,每个实例连接池上限为 15,总上限为 120;计划扩容到 12 个副本时,如果池上限仍为 15,总上限会变成 180,因此静态预算检查应直接拒绝。
但静态检查通过也不代表可以立即扩容。例如理论总上限为 150 时,当前已经有 145 个客户端连接,即使 150 没有超过 160 的业务预算,实际可用缓冲也只剩很小空间。完整门禁至少要同时检查“扩容后的理论上限不超过业务预算”和“当前实时水位低于发布设定的拒绝阈值”。必要时还可以把计划新增的连接需求纳入实时余量计算。
下面用 SQL 检查数据库最大连接数和当前客户端连接数。实际 max_connections 和当前连接数可能不同,发布系统应读取真实值。
SELECT
current_setting('max_connections')::integer AS max_connections,
40 AS reserved_connections,
current_setting('max_connections')::integer - 40 AS business_budget,
count(*) FILTER (WHERE backend_type = 'client backend') AS current_client_connections
FROM pg_stat_activity;预期结果
max_connections | reserved_connections | business_budget | current_client_connections
-----------------+---------------------+-----------------+--------------------------
200 | 40 | 160 | 145为扩容设置允许和拒绝条件
设扩容后的副本数为 R_new,池上限为 P_new,业务连接预算为 B,则静态条件必须满足 R_new × P_new ≤ B。同时定义实时拒绝阈值 W,要求当前实际客户端连接数低于 W;W 应低于 B,为连接建立抖动、后台任务和其他临时开销留出缓冲。
下面示例把两类检查合并到同一个发布门禁中:前者阻止配置超配,后者阻止数据库已经接近耗尽时继续扩容。示例中的阈值仅用于演示,生产环境应由容量基线确定。
#!/usr/bin/env bash
set -euo pipefail
MAX_CONNECTIONS=200
RESERVED_CONNECTIONS=40
REPLICAS_NEW=10
POOL_MAX_NEW=15
CURRENT_CLIENT_CONNECTIONS=145
RUNTIME_REJECT_THRESHOLD=144
BUSINESS_BUDGET=$((MAX_CONNECTIONS - RESERVED_CONNECTIONS))
REQUESTED_CONNECTIONS=$((REPLICAS_NEW * POOL_MAX_NEW))
if (( REQUESTED_CONNECTIONS > BUSINESS_BUDGET )); then
echo "DENY: requested=${REQUESTED_CONNECTIONS}, budget=${BUSINESS_BUDGET}"
exit 1
fi
if (( CURRENT_CLIENT_CONNECTIONS >= RUNTIME_REJECT_THRESHOLD )); then
echo "DENY: current=${CURRENT_CLIENT_CONNECTIONS}, runtime_threshold=${RUNTIME_REJECT_THRESHOLD}"
exit 1
fi
echo "ALLOW: requested=${REQUESTED_CONNECTIONS}, budget=${BUSINESS_BUDGET}, current=${CURRENT_CLIENT_CONNECTIONS}"预期结果
DENY: current=145, runtime_threshold=144这个示例中,扩容后的理论上限为 150,没有超过 160 的静态预算,但实时连接水位已经达到拒绝阈值,因此发布仍会失败。静态预算负责回答“配置上是否可能超配”,实时水位负责回答“现在是否还有足够缓冲”,两者共同构成扩容门禁。
让门禁覆盖真正的扩容变更
门禁不能只检查一次副本数。凡是增加副本数、提高连接池上限,或者同时修改两者的变更,都应重新计算扩容后的理论连接需求,并重新读取数据库实时连接水位。
生产环境还应把告警阈值和拒绝阈值分开:告警用于提前提醒容量接近临界点,拒绝阈值则决定发布是否允许继续。阈值应结合历史峰值、连接建立抖动和保留连接预算设置,而不是简单取 max_connections 的某个固定比例。
最终,连接扩容门禁应同时满足两个条件:配置层面不超过业务连接预算,运行层面没有逼近耗尽的实时水位。这样数据库连接容量就从扩容后的事故排查项,变成扩容前必须满足的工程约束。