如何在Flutter应用中开启sqflite数据库的并发写入能力
Flutter中启用sqflite并发写入能力的实现方案
基础原理说明
SQLite的shared-cache机制允许同进程内的多个数据库连接共享同一页缓存,打破sqflite默认单连接串行执行任务的限制,降低多写入任务之间的阻塞等待成本。需要注意的是,该机制下的并发写入并非完全无锁并行,最终的磁盘写入仍遵循SQLite的单写锁规则,核心收益是减少跨连接的缓存加载、锁等待的额外开销。
具体配置步骤
- 初始化数据库时开启shared-cache核心开关
直接在数据库打开的配置参数中传入对应标识,同时配置多实例连接池参数,代码示例:Future<Database> getDatabase() async { return openDatabase( 'app_local.db', options: OpenDatabaseOptions( // 开启shared-cache共享缓存模式 sharedCache: true, // 配置连接池最大实例数,移动端推荐3-4个即可 maxInstances: 4, version: 1, onCreate: (db, version) async { // 原有建表逻辑保持不变 await db.execute(''' CREATE TABLE record_table ( id INTEGER PRIMARY KEY, title TEXT, ts INTEGER ) '''); // 必须配套开启WAL日志模式,避免多连接锁冲突 await db.execute('PRAGMA journal_mode=WAL;'); }, ), ); } - 并发写入任务的执行规范
- 不要全局复用同一个Database实例执行多写入任务,每个独立的写入任务通过数据库工厂获取独立的连接实例,让连接池自动调度对应连接
- 所有写入操作必须包裹在显式事务中执行,避免单条语句单独提交造成的频繁磁盘同步,抵消多连接的性能收益
- 批量写入任务尽量拆分到不同的连接上执行,不要把所有写入逻辑塞到同一个连接的事务队列里
常见避坑点
- 连接池实例数不要设置过高,超过5个之后锁竞争的开销会超过并发带来的收益
- shared-cache模式下,连接本身的本地缓存不会实时同步其他连接的提交结果,需要读取最新一致性数据时,要主动触发对应连接的缓存刷新
- 开启shared-cache后不要使用跨库
ATTACH挂载其他数据库文件,部分SQLite版本会出现缓存一致性异常
内容的提问来源于stack exchange,提问作者puzzled
相关产品推荐
相关产品推荐

