PostgreSQL 19 为副本读取增加一致性等待
据介绍,PostgreSQL 19 新增 WAIT FOR LSN,可让备用节点等到指定 WAL 位置回放完成后再执行查询。应用可在主库写入后保存 LSN,并在后续副本读取前设置等待及超时。
AI 深度解读
主库刚写完,从库却查不到,是读写分离里很常见的麻烦。Simon Willison 在这篇 PostgreSQL 19 发布短评里,最看重的新功能就是 WAIT FOR LSN:让从库先等到指定的复制进度,再执行查询,帮助应用实现「读到自己刚写的数据」。
它值得前端和全栈开发者关注,因为「保存成功,刷新后却没了」有时并不是缓存或组件状态出了问题。数据库复制有延迟,而这个新命令为处理这类问题提供了明确的等待机制。
从库要等到哪里,才能读到刚才的写入
据原文,PostgreSQL 通常在 9 月发布新版本,PostgreSQL 19 这次晚了两个月。作者将主要原因归于 PostgreSQL 团队需要处理大量由 AI 报告的漏洞问题,但没有提供具体数量或核实情况。
作者认为等待值得,其中最吸引他的是「读己之写」(read-your-writes)一致性。
读写分离的应用把写操作交给主库,把部分查询交给从库。问题在于,从库重放写前日志(WAL)需要时间。写入成功后立即查询,从库可能还没有处理到那笔变更。
日志序列号(LSN)可以理解成日志里的进度坐标。应用拿到写入后的坐标,再要求从库追到这个位置,就有了明确的读取前提。
要等待的不是固定时长,而是具体的日志进度。
这比「保存后延迟一下再刷新」更有针对性。固定等待并不能证明从库已经追上;日志位置才说明它处理到了哪里。
两次请求之间,怎么传递这个进度
作者给出的第一步,是在主库更新数据后取得当前 WAL 插入位置:
UPDATE movie SET genre = 'Dramatic' WHERE genre = 'Drama';
SELECT pg_current_wal_insert_lsn();
要看的是第二行:pg_current_wal_insert_lsn() 会返回类似 0/0306EE20 的位置。应用需要保存这个值,以便后续请求使用。作者举的存储方式是带签名的 cookie。
随后,应用在从库会话中先等待,再查询:
WAIT FOR LSN '0/0306EE20' WITH (TIMEOUT '0.1s');
SELECT * FROM movie WHERE genre = 'Drama';
要看的是第一行:WAIT FOR LSN 等待从库把 WAL 重放到指定位置,之后才执行查询。这里将 Drama 改成了 Dramatic,所以第二段查询是在检查旧分类,而不是直接取回更新后的分类。
TIMEOUT '0.1s' 是可选参数。设置后,如果从库在规定时间内没有追上,会返回错误。原文没有描述应用收到错误后该如何处理。
因此,接入工作不止是加一条 SQL。应用还得把写入进度带到下一次请求,并决定等待失败时,是重试、改查主库,还是向用户返回失败。这些属于应用层策略,不能当作命令自带的行为。
为什么 Wikipedia 早就在用类似办法
作者第一次接触这种模式是在 Wikipedia。它背后的 MediaWiki 使用 MySQL 复制,也需要让用户在连续请求中看到顺序一致的事件。
原文引用的做法是:把主库的 binlog 位置保存在会话中,每次请求开始时,先等从库追到该位置,再读取数据。
这里的取舍很实际:可以容忍几秒延迟,但不希望用户连续访问时看到前后矛盾的画面。例如,上一页已经看到的修改,下一页又像没有发生。
作者指出,MediaWiki 相关代码如今使用 WAIT_FOR_EXECUTED_GTID_SET(),并回退到 MASTER_POS_WAIT()。这说明「记录写入位置,再等待副本追上」是一种已有实践。PostgreSQL 19 的新意,在于提供了对应的原生命令。
我的判断
我认可这个方向:它把读取条件从「大概等够了」变成「复制确实到了这里」,对写后立即读取的交互很有价值。
但这篇是功能短评,没有性能测试、吞吐对照或生产部署结果。作者也没有展示自己接入 PostgreSQL 19 后的实测数据,所以「值得等待」是他的判断,不能据此推导出接入成本低或性能影响小。
读己之写解决的是特定读取的可见性,不能直接等同于整个系统都获得了强一致性。
应用必须正确传递日志位置,并在相应的从库会话中等待。原文也没有展开显式事务、连接池和请求路由该如何配合,这些都需要在实际接入时核实。
与写后直接读主库相比,这种方式允许查询继续落在从库,但增加了进度传递、等待和错误处理。哪个方案更合适,要看主库负载和接口延迟要求,原文没有提供对照数据。
能拿来做什么
- 排查 Node 接口「保存成功却查不到」时,先确认写入和读取是否落在不同数据库节点,并检查复制延迟,再决定是否调整前端刷新逻辑。
- 对已经使用 PostgreSQL 读写分离的应用,可以挑一个写后立即读取的接口验证
WAIT FOR LSN,同时观察正常等待耗时和超时比例。 - 把
TIMEOUT '0.1s'当作示例值,结合接口的延迟要求设计等待上限,并明确超时后的处理方式。 - 如果只有少量接口需要读己之写,可以先比较写后读主库与等待从库两种方案的实现成本,再决定是否引入跨请求的 LSN 传递。