谨慎升级 PG 19
大版本升级从来不是只看 Release Notes 打勾,而是拿生产真实流量去“逼”出边界条件。PG 19 动了好几个底层默认值和锁机制,本文将提供一份清单按升级阻断排雷 → 四大核心专项实证 → 放行红线串起来,直接照着在预发环境跑一遍,能帮你省掉一半半夜救火的命。
零、升级前“硬门禁”排雷(不先清,pg_upgrade 直接拒签或实例起不来)
按顺序在原生产/预发旧库跑完以下预检:
清理已移除的 GUC 参数和认证方式PG 19 移除了 escape_string_warning(因standard_conforming_strings已强制恒为on)、移除了RADIUS认证;若从 PG 18 升级,旧参数io_workers也已移除,替换为io_min_workers、io_max_workers、io_worker_idle_timeout和io_worker_launch_interval四个参数。
grep -En 'escape_string_warning|io_workers|standard_conforming_strings' postgresql.conf postgresql.auto.conf
grep -inE 'radius|md5' pg_hba.conf
验证标准:配置文件中无 escape_string_warning、io_workers 与 radius 残留;若存在 md5 认证(PG 19 每次登录都会吐 Warning,可用 md5_password_warnings 临时静默),切记先设 password_encryption = 'scram-sha-256'、滚动重置完所有用户密码,最后再改 pg_hba.conf。
清查 pg_upgrade硬拦截对象PG 19 的pg_upgrade会直接拒绝包含MULE_INTERNAL编码数据库、含回车/换行符的库/角色/表空间名,以及使用btree_gist的inet/cidr索引(旧版该索引操作符类存在漏行 Bug,需删掉后改用原生 GiST 重建)。
-- 1) 检查 MULE_INTERNAL 编码
SELECT datname, pg_encoding_to_char(encoding)
FROM pg_database
WHERE pg_encoding_to_char(encoding) = 'MULE_INTERNAL';
-- 2) 检查库名/角色名/表空间名中的回车换行
SELECT'db'AS kind, datname ASnameFROM pg_database WHERE datname ~ E'[\r\n]'
UNIONALL
SELECT'role', rolname FROM pg_roles WHERE rolname ~ E'[\r\n]'
UNIONALL
SELECT'tablespace', spcname FROM pg_tablespace WHERE spcname ~ E'[\r\n]';
-- 3) 检查 btree_gist 的 inet/cidr 索引
SELECT n.nspname, c.relname AS index_name, op.opcname
FROM pg_index i
JOIN pg_class c ON c.oid = i.indexrelid
JOIN pg_namespace n ON n.oid = c.relnamespace
JOIN pg_opclass op ON op.oid = ANY(i.indclass)
WHERE op.opcname IN ('gist_inet_ops', 'gist_cidr_ops');
验证标准:三条 SQL 查询结果均为空集,且业务侧确认不依赖 json_array() 空结果返回 NULL(PG 19 改为返回空数组 [])及 postgres_fdw 在 READ ONLY 事务中写远端表(PG 19 已透传只读属性)。
一、JIT 评估实证:保 OLTP 稳态,防 OLAP 性能倒退
PG 19 把 jit 默认值从 on 改成了 off。对纯 OLTP 业务这是大礼包,能直接抹平 LLVM 误触发带来的毫秒级长尾毛刺;但如果你库里混跑着重度报表、大表聚合或跑批作业,升级后可能出现静默变慢。
在旧库捞出潜在受影响的“重查询清单”从 pg_stat_statements筛选平均单次耗时较长、高成本或实际吃过 JIT 编译时间的 SQL(注意 PG 15+ 自带jit_functions等列):
SELECT userid::regrole AS role_name,
queryid,
calls,
round(mean_exec_time::numeric, 2) AS mean_ms,
jit_functions,
round(jit_generation_time::numeric, 2) AS jit_gen_ms,
left(query, 120) AS sample_sql
FROM pg_stat_statements
WHERE jit_functions > 0OR mean_exec_time > 200
ORDERBY total_exec_time DESC
LIMIT30;
在 PG 19 预发库做 A/B 实证对比用与生产同量级的数据,对捞出的 Top 20–30 条 SQL 分别在 jit = off(PG 19 默认)和jit = on下各跑 3 次EXPLAIN (ANALYZE, BUFFERS),去掉首次冷缓存干扰后对比Execution Time与JIT: Time:
SET jit = off;
EXPLAIN (ANALYZE, BUFFERS) /* 目标 SQL */;
SET jit = on;
EXPLAIN (ANALYZE, BUFFERS) /* 目标 SQL */;
按角色精细放行,禁止全局回退仅对实测开启 JIT 后耗时下降超过 20% 的分析/报表账号按角色开启,在线交易账号保持关闭:
ALTERROLE olap_report_role SET jit = on;
验证标准:核心 OLTP 接口 P99 延迟无毛刺(甚至下降),且清单内所有重度报表在定向开启角色级 jit = on 后,耗时不劣于升级前基线。
二、REPACK (CONCURRENTLY) 生产级压测:锁尖刺、WAL 放大与磁盘底线
PG 19 原生 REPACK (CONCURRENTLY) 用逻辑解码代替了 pg_repack 的触发器,只读不写原表,只在最后切换文件时拿一次短暂的 ACCESS EXCLUSIVE 锁。但它有几条硬约束必须提前压测摸底:不支持分区主表(需对叶子分区逐个执行)、不支持 UNLOGGED 表、表必须有主键或 REPLICA IDENTITY 索引、单次执行期间并发变更超过约 1.04 亿行会失败,且受 max_repack_replication_slots(默认 5)限制。
压测前核验空间与前置条件
-- 查目标表总占用(预留至少 1 倍以上可用磁盘;若带 USING INDEX 排序,再多留 1 倍临时盘空间)
SELECT pg_size_pretty(pg_total_relation_size('public.orders')) AS total_size;
-- 确认有主键或 REPLICA IDENTITY 索引,且无 INVALID 索引
SELECT indexrelid::regclass, indisprimary, indisreplident, indisvalid
FROM pg_index
WHERE indrelid = 'public.orders'::regclass;
-- 核对槽位配额
SHOW max_repack_replication_slots;
施加等价生产写入并发 + 执行在线 REPACK开一个终端用 pgbench或业务回放工具持续对目标表执行UPDATE/DELETE/INSERT;另开独立会话(不要放进事务块或函数里),记录前后 WAL 位点并执行:
SELECT pg_current_wal_lsn() AS lsn_before;
SET statement_timeout = 0;
SET lock_timeout = '5s';
REPACK (CONCURRENTLY, VERBOSE, ANALYZE) public.orders;
SELECT pg_current_wal_lsn() AS lsn_after;
同步监控进度、WAL 放大率与切换卡顿在第三个会话持续轮询 PG 19 新增的 pg_stat_progress_repack视图,并在结束后计算 WAL 增幅:
SELECT pid, phase, heap_blks_total, heap_blks_scanned, tuples_done
FROM pg_stat_progress_repack;
-- 压测结束后计算总 WAL 增量,对比纯 pgbench 同等时长基线
SELECT pg_size_pretty(pg_wal_lsn_diff('lsn_after'::pg_lsn, 'lsn_before'::pg_lsn));
验证标准:
切换瞬间的读写阻塞尖刺在业务容忍阈值内(实证常态在百毫秒到亚秒级,无 lock_timeout超时);实测 WAL 增量(通常比平时高 4%–25%)不会撑爆归档带宽、从库回放延迟或 pg_wal分区;确认现有自动化维护脚本里涉及分区表的任务已改写为遍历叶子分区,且并发度不超过 max_repack_replication_slots。
三、锁配置、等待事件与 Vacuum 限流校验
PG 19 对锁和后台清理做了三处极其容易被忽略的底层改动:
max_locks_per_transaction默认值从 64 翻倍到 128,因为锁哈希表的共享内存分配逻辑取消了隐式余量,官方明确指出你以前手工配置的数值在 PG 19 需要翻倍才能维持同等锁容量;log_lock_waits默认改为on,同时新增系统视图pg_stat_lock(记录waits、wait_time和fastpath_exceeded);缓冲等待事件改名: BUFFERPIN改为BUFFER,BufferPin改为BufferCleanup,BufferContent拆分为BufferShared、BufferShareExclusive、BufferExclusive;并行 VACUUM的 leader 和 worker 改为共享vacuum_cost_limit,以前每个 worker 各吃一份预算,升级后大表并行清理可能会变慢。
实证操作与校验步骤:
按 2 倍原则审计
max_locks_per_transaction如果你在旧库postgresql.conf里显式覆盖过这个参数(尤其是上百个子分区的库),升级配置模板里先按 原值 × 2 调整并重启压测。高压跑完典型多分区/长事务,查
pg_stat_lock盯紧快路径溢出
SELECT * FROM pg_stat_lock;
重点看 fastpath_exceeded 计数——如果该数值在压测期间高速飙升,说明单事务持有的关系锁超过了快路径槽位,正在频繁退化到全局主锁表争抢 LWLock,应继续调高 max_locks_per_transaction。
压测日志盘吞吐与监控适配
在锁竞争高峰模拟压测中,观察 log_lock_waits = on下每小时 PG 日志增量,确保日志盘不会被打满(若旧业务本身存在大量刻意等待的排他锁,适当调大deadlock_timeout以减少日志噪音)。回归 Prometheus / postgres_exporter/ Zabbix 等观测面板,把旧的BufferPin、BufferContent、BUFFERPIN指标告警规则更新为 PG 19 新名称。对千万级多索引大表跑一次并行 VACUUM(含新特性 Autovacuum 并行清理),对比升级前清理总耗时,若受共享vacuum_cost_limit影响变慢,按需调高vacuum_cost_limit或表级参数。
验证标准:高并发分区查询压测下零 out of shared memory 报错、fastpath_exceeded 增长可控、日志盘 24 小时预估占用安全、监控大盘所有等待事件指标采集无断层。
四、逻辑复制与零停机切流校验:免重启切换、序列同步与监控避坑
PG 19 打通了逻辑复制的最后两道关卡,但两个新特性都有极易踩空的“隐形前提”:
校验 wal_level = replica动态升降级,谨防备库逻辑槽团灭PG 19 在wal_level = replica下创建第一个逻辑复制槽时,内核会自动把effective_wal_level抬到logical,删掉最后一个槽后由checkpointer异步降回replica。致命避坑点:如果你的架构存在级联备库上的逻辑复制槽(比如从只读备库接 CDC),一旦主库删光了自己的逻辑槽导致effective_wal_level自动降级回replica,备库上所有逻辑槽会被立刻标为失效(invalidation_reason = 'wal_level_insufficient')!
-- 1) 压测验证动态抬升与回落
SHOW wal_level; -- 应为 replica
SHOW effective_wal_level; -- 无逻辑槽时为 replica
SELECT pg_create_logical_replication_slot('test_slot_19', 'pgoutput');
SHOW effective_wal_level; -- 应立刻变为 logical
SELECT pg_drop_replication_slot('test_slot_19');
-- 等待 checkpointer 异步回落后再次检查
SHOW effective_wal_level;
验证标准:若仅主库按需用逻辑槽(如临时跑 REPACK (CONCURRENTLY)),保持 wal_level = replica 即可;凡是备库跑逻辑复制/CDC 的集群,主库务必显式配死 wal_level = logical,不依赖动态降级。
校验序列同步的“非流式”语义(切流防主键冲突)PG 19 新增的序列逻辑复制不会实时流式同步 nextval()变更,只在CREATE SUBSCRIPTION、ALTER SUBSCRIPTION ... REFRESH PUBLICATION和ALTER SUBSCRIPTION ... REFRESH SEQUENCES时同步一次快照,且要求发布端也运行在 PG 19 及以上。
老版本(如 PG 14–18)逻辑升级到 PG 19:发布端不是 PG 19,无法享受原生序列同步,切流脚本照旧必须保留手动 setval()步骤。PG 19 之间逻辑同步/容灾切换:在停写旧主库、确认表数据追平后的切流窗口,必须在订阅端显式执行:
ALTER SUBSCRIPTION my_sub REFRESH SEQUENCES;
验证标准:切流演练中,执行完 REFRESH SEQUENCES 后,在目标库抽查核心自增表的 last_value 大于等于源库终态值,新写入第一批业务数据零 duplicate key value violates unique constraint 报错。
修复逻辑复制监控视图的列名变更PG 19 把 pg_stat_subscription_stats里的sync_error_count改名为sync_table_error_count(因序列同步错误独立拆出统计)。
SELECT subname, apply_error_count, sync_table_error_count
FROM pg_stat_subscription_stats;
验证标准:所有订阅端监控采集脚本已替换新列名,无 column "sync_error_count" does not exist 报错。
生产升级实证总控速查表
| 硬门禁排雷 | escape_string_warning / io_workers / RADIUS;禁 btree_gist inet 索引 | pg_hba.conf” | |
| JIT 评估 | jitoff | off/on A/B 压测 | jit = on |
| REPACK 压测 | REPACK (CONCURRENTLY) 走 WAL 逻辑解码 | pg_stat_progress_repack | lock_timeout;WAL 增幅与切换尖刺在 SLA 内;不直接跑分区主表 |
| 锁与清理 | max_locks_per_transactionlog_lock_waits 默认 on;新增 pg_stat_lock | fastpath_exceeded;回归等待事件监控 | |
| 逻辑复制 | replicaREFRESH SEQUENCES;视图列改名 | logical;切流无主键冲突;监控无报错 |