How Tailscale helped find the SQLite WAL-Reset bug

摘要

Tailscale 团队分享了他们如何定位并修复一个潜伏在 SQLite 中至少 16 年的罕见数据竞争 bug（WAL-Reset bug）的全过程。文章详细描述了他们的数据库架构（单写者 SQLite 分片）、遇到的 19 次数据库损坏事件、排查过程中的各种尝试（包括寻求 SQLite 官方支持、部署事务日志管道和 tmstmpvfs 调试工具），最终定位到 checkpoint 与写事务之间的竞争条件。文章还讲述了修复版本 3.52.0 因引入另一个问题被撤回、改用 3.51.3，以及他们如何通过补丁日志获得正面证据确认修复有效。