在读写分离架构中,应用把写入交给主库,把查询交给备库。但如果备库尚未回放最新写入,用户随后发起的查询就可能看不到自己刚修改的数据。
这也是适合在写好标智库讨论的一类数据库工程问题:如何在使用备库承担读取的同时,让用户看见自己刚完成的修改?
PostgreSQL 19 新增的 WAIT FOR LSN 命令,针对的正是这种“读己之写”(read-your-writes)一致性需求。
核心思路:查询前,先等备库追上
WAIT FOR LSN 允许备库上的会话等待,直到备库将预写日志(WAL)回放到指定的日志序列号(LSN),再继续执行后续查询。
应用的处理流程可以拆成两步:
- 在主库完成写入后,记录对应的 WAL 位置。
- 后续请求访问备库时,先等待备库回放到该位置,再读取数据。
关键不在于假设复制足够快,而在于给读取设置一个明确的前提:备库已经回放了这次写入。
使用示例
先在主库上更新数据,并获取当前的 WAL 插入位置:
UPDATE movie SET genre = 'Dramatic' WHERE genre = 'Drama'; SELECT pg_current_wal_insert_lsn(); 这里应确保写入已经提交,再获取供后续请求使用的位置;例如,按自动提交模式依次执行上述语句。
第二条语句会返回类似 0/0306EE20 的值。应用需要保存这个位置,例如将它放进签名 Cookie,供后续请求携带。
随后,在备库上先等待目标日志位置,再执行查询:
WAIT FOR LSN '0/0306EE20' WITH (TIMEOUT '0.1s'); SELECT * FROM movie WHERE genre = 'Drama'; 注意,查询仍然筛选 Drama,而前面的更新已将该类别改为 Dramatic。等待成功后,查询应反映这次更新后的状态,而不是继续看到尚未回放更新时的旧数据。
超时后会发生什么?
示例中的 TIMEOUT '0.1s' 为等待设置了时限。
如果备库未能在指定时间内回放到目标 LSN,命令会报错。因此,应用需要区分两种结果:
- 等待成功:继续执行读取。
- 等待超时:处理错误,不能把这次等待视为已经满足一致性条件。
TIMEOUT 参数是可选的,可以省略。
MediaWiki 中的类似实践
MediaWiki 也采用过类似机制,以保持用户连续请求之间所见数据的一致性:将主库的 binlog 位置保存在会话中,每次请求开始时,先等待副本追上该位置,再执行读取。
这种设计允许复制存在几秒延迟,但希望避免用户在后续请求中看到状态“倒退”。
在 MySQL 复制环境下,MediaWiki 的相关实现使用 WAIT_FOR_EXECUTED_GTID_SET(),并以 MASTER_POS_WAIT() 作为回退方案。
它与 WAIT FOR LSN 的共同点是:用明确的复制进度作为读取前的等待条件,而不是直接假设备库已经同步。
小结
WAIT FOR LSN 将“先确认备库追上,再读取”的流程变成了显式命令。应用记录主库写入后的 WAL 位置,并在后续备库查询前等待该位置,就能围绕具体写入建立“读己之写”的读取流程。
使用时需要同时关注两个环节:写入提交后的位置记录,以及等待超时后的错误处理。




