Firestore读写完全禁用缓存：离线写入失败需求实现求助

这个问题我之前也碰到过，Firestore的写入行为确实和读取逻辑不一样，咱们一步步拆解解决：

首先得明确一个核心点：Firestore的写入操作（包括set、batch.commit这类），哪怕你禁用了本地持久化（setPersistenceEnabled(false)），离线时依然会把操作暂存在内存队列里，等恢复联网后自动执行。这就是为什么你离线时没收到失败回调，联网后才触发完成的原因——setPersistenceEnabled(false)只是关掉了磁盘层面的缓存，内存里的操作队列还是会正常工作，所以对写入的离线行为完全没影响。

要实现你想要的「离线时写入直接触发失败回调」的效果，目前Firestore没有提供原生配置项，得通过手动检查网络状态来干预，具体可以这么做：

1. 执行写入前先检查网络连接 #

在调用Firestore的写入方法前，先判断当前设备是否联网，如果没联网，直接触发失败回调，不执行Firestore操作。

给你一个Android平台的Kotlin示例：

// 工具方法：检查当前是否有可用网络
fun isDeviceOnline(context: Context): Boolean {
    val connectivityManager = context.getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
    val activeNetwork = connectivityManager.activeNetwork ?: return false
    val networkCapabilities = connectivityManager.getNetworkCapabilities(activeNetwork) ?: return false
    return networkCapabilities.hasCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
}

// 你的写入逻辑
fun writeData(myObject: MyObject, context: Context, yourCompletionListener: OnCompleteListener<Void>) {
    if (!isDeviceOnline(context)) {
        // 离线状态，直接触发失败回调
        yourCompletionListener.onComplete(Task.forException(IOException("设备未联网，写入失败")))
        return
    }
    // 联网状态，执行Firestore写入
    getFireStoreInstance()
        .collection(PATH)
        .document(myObject.id)
        .set(myObject)
        .addOnCompleteListener(yourCompletionListener)
}

2. 监听网络状态变化（可选） #

如果需要动态处理网络切换的场景，可以注册一个网络回调，实时监听网络状态变化，比如在离线时直接拒绝写入操作：

val connectivityManager = context.getSystemService(Context.CONNECTIVITY_SERVICE) as ConnectivityManager
val networkCallback = object : ConnectivityManager.NetworkCallback() {
    override fun onAvailable(network: Network) {
        // 网络恢复，允许执行写入操作
    }

    override fun onLost(network: Network) {
        // 网络断开，拒绝写入或提示用户
    }
}

// 注册网络回调
connectivityManager.registerNetworkCallback(
    NetworkRequest.Builder()
        .addCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET)
        .build(),
    networkCallback
)

补充说明 #

Firestore的设计初衷是保证数据的最终一致性，所以即使离线也会尽力缓存写入操作，等联网后同步。如果你确实需要严格的「离线即失败」逻辑，手动检查网络是目前唯一可行的方案。

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