You need to enable JavaScript to run this app. 如何在Flutter应用中开启sqflite数据库的并发写入能力
优惠活动
大模型
产品
解决方案
定价
更多

如何在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 16:36:01