2026 跨区 Mac Mini M4 并联集群
共享卷 SQLite WAL、检查点 IO 与构建锁决策矩阵

共享卷 + WAL：三类典型抖动

面向裸金属 Mac 多机并联、元数据或缓存放网络挂载的团队。固定 URL：2026-clustervps-macmini-sqlite-wal-shared-volume-matrix.html。调度与 flock 见《Nomad 亲和、构建锁与磁盘水位》；rsync 见《跨区并联集群 rsync 决策矩阵》；DNS／制品库见《拆分 DNS 与制品库矩阵》；远程抖动见《Mosh 与 SSH 抖动》。技术博客首页。

• 检查点与构建抢盘：自动或手动 wal_checkpoint 写回主库时，与 Xcode 等大量小文件 IO 争用同盘或 NAS，p95 编译时间拉长。
• 网络 FS 语义：部分 SMB／NFS 不满足 SQLite 锁与缓存假设；多写者或客户端缓存异常放大损坏风险。
• 水位与 WAL：-wal／-shm 占卷；1TB 上叠 DerivedData 与长 WAL 易「看似有空间、写已失败」。

决策矩阵：部署形态 × journal_mode × 风险

能不放共享卷就不放；若强制，用单写入队列串行化写路径，Mac Mini M4 本地 SSD 留给编译与热缓存。

可粘贴：连接后 PRAGMA 与 journal_mode

在 sqlite3 /path/to/app.db 或应用首连逻辑中按需执行（路径与同步级别请按合规与容灾要求裁剪）：

-- 新建库或迁移完成后一次性确认模式（共享卷慎用 WAL）
PRAGMA journal_mode=WAL;          -- 仅当库在本机 SSD 或已验证 NAS 锁语义时
PRAGMA synchronous=NORMAL;        -- 本机 SSD 常用折中；网络卷倾向 FULL 或改架构
PRAGMA wal_autocheckpoint=400;  -- 默认 1000 页；IO 抖动大时下调，减轻突发写回
PRAGMA busy_timeout=8000;       -- 毫秒；缓解短时锁竞争，不能替代单写者设计
PRAGMA mmap_size=0;             -- 在部分网络挂载上关闭 mmap 更易观测与排错
PRAGMA foreign_keys=ON;

WAL 持续增长且水位紧：维护窗执行 PRAGMA wal_checkpoint(TRUNCATE);，且无并发写。改 journal_mode=DELETE 须低峰并先备份。

队列并发上限（实操取值）

同一路径上 SQLite 仍是单写者：对会写该库的 CI／Nomad job 设写并发 = 1（队列深度 1）。检查点与重编译同盘时，单机编译并发先压 2～4，看监控再调；勿假设各 NFS 客户端缓存一致。

构建锁与检查点错峰

提升目录、合并索引等临界区用 flock 或 max_parallel=1 二选一作权威串列（见 Nomad 姊妹篇）；主动 checkpoint 放入同一互斥窗。锁文件放本机，勿在网络挂载上依赖 OS 锁。

1TB / 2TB 磁盘水位验收清单

验收以集群最满卷为准。

常见问题（FAQ）

WAL 一定比 DELETE 快吗？在本机 SSD 上通常如此；在共享卷上若检查点与业务写冲突，DELETE 有时反而更易预测尾延迟——请以压测为准。

自动检查点可以关掉吗？可通过 wal_autocheckpoint=0 关闭自动检查点并改用手动维护窗；代价是 WAL 文件可能持续增长，必须配套监控与磁盘水位。

多机读同一库可以吗？只读多机可行；写须串行化，勿让只读连接池误接迁移写。