Android Firestore获取离线持久化独占锁失败问题求助

这个错误通常是因为多个Firestore客户端实例竞争离线持久化的独占锁，或者在不合适的线程模型下重复访问Firestore导致的。结合你的场景（Service中定时上传位置），可以通过以下几个步骤解决：

1. 确保Firestore实例是全局单例 #

不要每次上传位置时都创建新的FirebaseFirestore实例，多个实例会同时尝试获取离线存储的锁，从而触发这个错误。建议在Application类中初始化一个全局单例：

public class MyApplication extends Application {
    private static FirebaseFirestore sFirestoreInstance;

    @Override
    public void onCreate() {
        super.onCreate();
        FirebaseApp.initializeApp(this);
        // 初始化全局Firestore实例
        sFirestoreInstance = FirebaseFirestore.getInstance();
        
        // 可选：如果不需要离线持久化，可以关闭它（避免锁竞争）
        // FirebaseFirestoreSettings settings = new FirebaseFirestoreSettings.Builder()
        //         .setPersistenceEnabled(false)
        //         .build();
        // sFirestoreInstance.setFirestoreSettings(settings);
    }

    public static FirebaseFirestore getFirestore() {
        return sFirestoreInstance;
    }
}

记得在AndroidManifest.xml中声明这个Application类：

<application
    android:name=".MyApplication"
    ...>
    ...
</application>

2. 优化定时任务的线程模型 #

你的代码中用TimerTask结合Handler.post把Firestore操作切回主线程，这不仅没必要，还可能加剧线程竞争。Firestore的API本身就是异步的，完全可以在后台线程直接执行：

推荐用ScheduledExecutorService替代TimerTask（它比TimerTask更稳定，能更好地处理线程异常），示例代码如下：

public class LocationUploadService extends Service {
    private ScheduledExecutorService mScheduler;
    private User mUser;
    private LatLng mLatLong;

    @Override
    public void onCreate() {
        super.onCreate();
        // 初始化单线程的定时任务调度器
        mScheduler = Executors.newSingleThreadScheduledExecutor();
        
        // 启动定时任务：延迟0秒开始，每10秒执行一次
        mScheduler.scheduleAtFixedRate(new Runnable() {
            @Override
            public void run() {
                if (mLatLong == null || mUser == null) {
                    Log.d("TAG", "位置或用户信息为空，跳过上传");
                    return;
                }
                
                Log.d("TAG", "准备上传位置：" + mLatLong);
                // 获取全局单例的Firestore实例
                FirebaseFirestore firestore = MyApplication.getFirestore();
                
                // 直接在后台线程执行Firestore写入操作
                firestore.collection(Constants.LOCATION_REFERENCE)
                        .document(mUser.getUid())
                        .set(mLatLong, SetOptions.merge())
                        .addOnSuccessListener(aVoid -> Log.d("TAG", "位置上传成功"))
                        .addOnFailureListener(e -> Log.e("TAG", "位置上传失败", e));
            }
        }, 0, 10, TimeUnit.SECONDS);
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        // 停止定时任务，避免内存泄漏
        if (mScheduler != null && !mScheduler.isShutdown()) {
            mScheduler.shutdown();
        }
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}

3. 额外检查点 #

• 确认你的App中没有其他地方同时初始化FirebaseFirestore实例，所有Firestore操作都复用全局单例。
• 如果你的业务允许关闭离线持久化，直接在初始化时设置setPersistenceEnabled(false)可以彻底避免锁竞争问题，但会失去离线缓存的能力。

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