PostgreSQL 16 默认不复制 DELETE,需在 CREATE PUBLICATION 中显式指定 publish = 'insert, update, delete' 或 publish = 'all'(不推荐),且目标表必须有主键或有效 REPLICA IDENTITY,订阅端表结构须预先存在并禁用干扰触发器。

PostgreSQL 16 默认不捕获 DELETE,除非你显式配置发布(PUBLICATION)允许它 —— 这是多数人踩坑的第一步。
CREATE PUBLICATION 必须显式声明 publish = 'insert, update, delete'
默认情况下,CREATE PUBLICATION 只发布 INSERT 和 UPDATE,DELETE 被排除在外。想捕获 DELETE,必须在创建时用 WITH (publish = ...) 明确列出:
CREATE PUBLICATION my_pub FOR TABLE orders WITH (publish = 'insert, update, delete');
- 遗漏
delete会导致订阅端收不到任何DELETE消息,即使原表已执行成功 -
publish = 'all'是等效写法,但不推荐:它隐含包含truncate,而TRUNCATE在 PostgreSQL 16 中仍不被逻辑复制支持(会报错ERROR: TRUNCATE is not supported in logical replication) - 修改已有 publication 的
publish属性需先DROP再重建,无法ALTER PUBLICATION ... SET
目标表必须有有效的 REPLICA IDENTITY
DELETE(和 UPDATE)依赖行标识来定位被删/改的记录。若表没有主键或唯一索引,PostgreSQL 16 会拒绝应用 DELETE 到订阅端,报错类似:ERROR: could not find tuple to delete。
- 最稳妥做法:确保表有主键(
PRIMARY KEY),这是REPLICA IDENTITY的默认值 - 若无主键,可手动设置:
ALTER TABLE orders REPLICA IDENTITY USING INDEX idx_orders_id;(要求该索引是UNIQUE且不含空值) - 设为
FULL(REPLICA IDENTITY FULL)虽能绕过索引要求,但会显著增加 WAL 体积和网络带宽,仅用于调试,不可上生产
订阅端必须已存在对应表结构,且不能有触发器干扰
逻辑复制不传输 DDL,所以 orders 表必须在订阅库中预先建好,字段名、类型、顺序都要一致。更隐蔽的问题是触发器:
- 如果订阅端表上有
BEFORE DELETE触发器,且其函数返回NULL,会导致该行“被跳过”,看似DELETE没生效 - 建议在订阅端禁用所有非必要触发器:
ALTER TABLE orders DISABLE TRIGGER ALL; - 注意:禁用触发器不影响复制本身,只影响本地对同步数据的额外处理
验证 DELETE 是否真正被捕获
别只查订阅端数据是否消失——那可能是其他操作导致的。要确认是逻辑复制传递的 DELETE,直接查复制槽活动:
SELECT slot_name, plugin, database, active, pg_wal_lsn_diff(pg_current_wal_lsn(), restart_lsn) AS behind_wal FROM pg_replication_slots WHERE slot_type = 'logical';
- 若
behind_wal持续增长,说明DELETE事务卡在解码或应用阶段,常见于订阅端索引缺失或约束冲突 - 检查订阅状态:
SELECT subname, status, reason FROM pg_subscription_rel WHERE subname = 'my_sub';,状态为r(ready)才表示该表已同步就绪 - 最直接验证:在发布端执行
DELETE后,立刻在订阅端查pg_stat_replication的state字段是否为streaming,再查目标表行数变化
最容易被忽略的是 REPLICA IDENTITY 的实际生效条件——它不仅要求存在,还要求所依赖的索引未被 VACUUM 或 ANALYZE 意外失效;线上表若长期未维护,可能某次自动 VACUUM 后 DELETE 就开始静默失败。










