应用重启后Firebase磁盘持久化功能失效问题排查

首先，从你描述的现象和日志信息来看，问题主要出在离线写入的数据持久化完整性和重启后的身份验证/网络连接这两个环节，下面一步步拆解：

一、先确认离线写入是否真的成功持久化 #

Firebase的setValue在离线时是异步写入本地持久层的，你之前没有监听写入完成的回调，无法确认数据是否真的被保存到本地。建议给setValue加上CompletionListener，验证离线写入的结果：

mDatabase.child(spamuId).setValue(contactSpam, new DatabaseReference.CompletionListener() {
    @Override
    public void onComplete(DatabaseError error, DatabaseReference ref) {
        if (error != null) {
            Log.e("FirebasePersistence", "离线写入失败: " + error.getMessage());
        } else {
            Log.d("FirebasePersistence", "数据已成功写入本地持久层");
        }
    }
});

如果离线时这个回调没有触发成功，说明数据根本没被写到本地，重启后自然不会有同步的可能。常见的原因包括：数据库路径权限配置问题（即使离线，Firebase也会先检查本地缓存的规则，如果规则不允许写入，离线写入也会失败）、或者磁盘空间不足导致持久化失败。

二、重启后同步失败的核心线索：Auth Token获取失败 #

从你补充的测试按钮日志可以看到，反复出现：

D/PersistentConnection: pc_0 - Error fetching token: A network error (such as timeout, interrupted connection or unreachable host) has occurred.

这说明重启后应用联网时，Firebase无法获取身份验证令牌，导致无法建立与服务器的有效连接，自然无法同步本地持久化的数据。针对这个问题，你可以排查以下几点：

1. 检查网络权限与连接状态 #

• 确保你的AndroidManifest.xml中添加了必要的网络权限：

  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
  

• 如果是Android 10及以上版本，检查应用是否被限制了网络访问（比如在系统设置里开启了"禁用移动数据"或"禁用WLAN"），或者设备处于代理/防火墙环境下，阻止了与Google Auth服务的连接。

2. 确认用户身份的一致性 #

Firebase的本地持久化数据是与当前认证用户绑定的：

• 如果你使用的是匿名登录，重启后Firebase默认会生成新的匿名用户，旧用户的本地数据不会同步到新用户的路径下。解决方法是启用Auth的持久化：

  FirebaseAuth.getInstance().setPersistenceEnabled(true);
  

  这样重启后会保留之前的匿名用户会话，数据就能正常同步。
• 如果你使用的是其他登录方式（邮箱/Google登录等），确保重启后应用自动完成了登录流程，没有处于未认证状态。如果数据库规则要求认证才能写入，未认证状态下即使本地有数据，也无法同步到服务器。

3. 检查Firebase依赖版本 #

旧版本的Firebase SDK可能存在持久化或Auth的bug，建议更新到最新的Firebase BOM（Bill of Materials）来统一管理依赖版本：
在你的build.gradle（Project级）中添加：

dependencies {
    // Firebase BOM
    implementation platform('com.google.firebase:firebase-bom:32.7.0')
    // 然后添加你需要的Firebase组件，无需指定版本
    implementation 'com.google.firebase:firebase-database'
    implementation 'com.google.firebase:firebase-auth'
}

三、额外的排查点 #

• 查看设备的磁盘空间：如果磁盘已满，Firebase无法持久化数据，重启后数据会丢失。
• 检查Firebase控制台的数据库规则：确保规则允许你使用的用户身份进行写入操作，即使离线，Firebase也会验证本地缓存的规则，如果规则不允许，离线写入会失败。

按照上面的步骤逐一排查，应该能定位到问题所在。

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