在嵌入式系统和资源受限的高并发场景中，SQLite 的默认配置往往无法发挥最佳性能。通过合理的 PRAGMA 参数调优，可以在有限的内存资源下实现更高的吞吐量和更好的响应稳定性。本文聚焦于四个核心 pragma 参数 ——cache_size、mmap_size、page_size 和 synchronous—— 给出工程化的配置建议与监控要点。
一、cache_size：页缓存大小的精细控制
cache_size pragma 用于指定 SQLite 的页缓存大小，单位为 KB，负值表示 KB 单位。默认值通常为负 2000，即 2MB 的缓存空间。在嵌入式高并发场景中，适当增大缓存可以显著减少磁盘 I/O，提升查询性能。
工程建议：将 cache_size 设置为负 8000 至负 64000 之间，即 8MB 到 64MB 的缓存规模。具体取值需根据目标设备的可用内存进行评估 —— 若设备总内存为 256MB，建议分配 16MB 至 32MB 给 SQLite 缓存；若内存更为紧张，可降至 8MB 至 12MB。配置方式为PRAGMA cache_size = -16000;（16MB）。需要注意的是，该值在数据库连接关闭后不会持久化，若需永久生效，应在每次连接时重新设置，或通过 ALTER TABLE 修改数据库的 schema 来实现持久化。
二、mmap_size：内存映射 I/O 的容量规划
mmap_size pragma 控制 SQLite 使用内存映射 I/O 的最大字节数。启用内存映射后，操作系统可以将数据库文件的部分页面直接映射到进程地址空间，减少传统 read/write 系统调用的开销。在读多写少的场景下，mmap_size 能带来明显的性能提升。
工程建议：对于嵌入式设备，mmap_size 的推荐范围为 256MB 至 1GB。具体配置时，应确保不超过设备可用虚拟地址空间，并留有足够余量给其他组件。若系统同时运行多个 SQLite 连接，建议将 mmm_size 设置在 256MB 至 512MB 之间，避免内存竞争。配置示例：PRAGMA mmap_size = 268435456;（256MB）。需要警惕的是，在某些嵌入式系统上，过大的 mmap_size 可能导致内存压力，建议在部署前进行压测验证。
三、page_size：数据库页大小的选择
page_size 决定了数据库文件的物理页大小，可选值包括 1024、2048、4096、8192 字节等。页大小影响磁盘空间利用率、I/O 效率和索引性能之间的平衡。
工程建议：对于嵌入式场景，4096 字节是较为均衡的选择。这一页大小在大多数文件系统上都能获得较好的 4K 对齐，减少读写放大。若存储设备具有更大的物理块（如 8K 或 16K），可考虑使用 8192 字节以进一步优化顺序写入性能。需注意的是，page_size 必须在创建数据库时指定，修改已有数据库的 page_size 需要重建表，代价较高。配置方式为PRAGMA page_size = 4096;，随后执行 VACUUM 使设置生效。
四、synchronous：写入安全与性能的权衡
synchronous pragma 控制数据库文件的同步模式，直接影响写入安全性与性能。取值为 0（OFF）、1（NORMAL）、2（FULL）、3（EXTRA）。NORMAL 模式下，SQLite 在每次事务提交时确保数据已写入磁盘，是安全与性能的最佳平衡点。FULL 模式提供最强保证但写入速度最慢，OFF 模式最快但可能在系统崩溃时丢失数据。
工程建议：对于大多数嵌入式高并发场景，推荐使用 synchronous = 1（NORMAL）。该模式在数据安全和写入性能之间取得较好平衡，能够应对大多数意外断电情况。若写入负载极高且可接受少量数据丢失风险，可临时降级至 synchronous = 0（OFF），但必须在应用层做好数据校验与重试机制。对于日志类或缓存类场景，NORMAL 模式已足够保障数据完整性。
五、高并发场景的组合配置
单一参数的优化效果有限，需要结合多个 pragma 参数形成完整的配置策略。以下是一套适用于嵌入式高并发写入场景的推荐配置组合，适用于 256MB 至 512MB 内存的嵌入式设备：
PRAGMA journal_mode = WAL; -- 启用WAL模式提升并发读性能
PRAGMA synchronous = 1; -- NORMAL模式平衡安全与性能
PRAGMA cache_size = -16384; -- 16MB页缓存
PRAGMA mmap_size = 268435456; -- 256MB内存映射
PRAGMA page_size = 4096; -- 4KB页大小
PRAGMA busy_timeout = 5000; -- 5秒锁等待超时
PRAGMA temp_store = MEMORY; -- 临时表存入内存
WAL 模式是高并发场景的关键配置，它允许多个读连接与一个写连接并发执行，显著提升读多写少场景的吞吐量。busy_timeout 参数控制写锁等待时间，建议设置为 3000 至 10000 毫秒，避免在高并发写入时出现 "SQLITE_BUSY" 错误。
六、监控指标与调优迭代
配置完成后，应持续监控以下关键指标以验证调优效果：查询响应时间的 P99 百分位、磁盘 I/O 等待时间、内存使用量峰值、以及 "SQLITE_BUSY" 错误的出现频率。若发现响应时间过长或 busy 错误频繁，可尝试进一步增大 cache_size 或调整 busy_timeout；若内存压力明显，则需反向压缩 mmap_size 和 cache_size 的配置值。
综上所述，SQLite 在嵌入式高并发场景下的性能优化本质上是一场资源与吞吐量的权衡游戏。通过合理设置 cache_size、mmap_size、page_size 和 synchronous 等核心 pragma 参数，结合 WAL 模式和适当的锁超时策略，即可在资源受限的环境中实现稳定高效的数据访问。