Firestore enablePersistence已废弃，Web端如何处理Firestore缓存？

在cloud_firestore: ^4.15.5版本中，Flutter Web端完全支持Firestore本地缓存，配置逻辑和移动端基本一致，仅存在细微的专属配置项。

具体操作步骤 #

• 初始化时配置缓存
  Web端默认已开启本地缓存，若需手动确认或调整，可在Firestore实例初始化时通过Settings类配置：

  import 'package:cloud_firestore/cloud_firestore.dart';
  import 'package:firebase_core/firebase_core.dart';
  
  Future<void> initFirebase() async {
    await Firebase.initializeApp();
    final db = FirebaseFirestore.instance;
    
    // 开启本地持久化缓存，和移动端写法一致
    db.settings = const Settings(
      persistenceEnabled: true,
      // Web端专属：可选缓存模式，LOCAL为持久化到浏览器本地存储（关闭浏览器仍保留），SESSION为会话级缓存（关闭浏览器即清除）
      persistenceMode: PersistenceMode.LOCAL,
    );
  }
  

• 禁用缓存
  若不需要缓存，直接将persistenceEnabled设为false即可。
• 手动管理缓存
  如果需要清空本地缓存，可调用Firestore实例的clearPersistence()方法：

  await FirebaseFirestore.instance.clearPersistence();
  

补充说明 #

你在移动端使用的db.settings = const Settings(persistenceEnabled: true);代码，在Web端同样有效。Web端额外提供的persistenceMode参数，可让你更精细地控制缓存的存储生命周期。离线状态下，Firestore会自动读取本地缓存数据；在线时则会同步云端最新数据，这一逻辑和移动端完全一致。

内容的提问来源于stack exchange，提问作者Claudiu Razlet