React Native离线状态下Firestore无法调用.set()创建文档问题

我之前也碰到过类似的棘手情况，先来帮你拆解问题：你提到离线时.update()、.get()和.delete()都能正常工作，但.set()创建新文档就抛出firestore/unavailable错误，核心原因大概率和Firestore离线持久化的配置或者新文档的本地缓存机制有关。

可能的原因与解决方案 #

1. 未正确启用Firestore离线持久化 #

React Native环境下，Firestore的离线持久化默认是关闭的（和Web端默认启用的逻辑不同）。对于已存在的文档，.get()可以读取本地缓存，.update()/.delete()也能操作缓存中的条目，但创建新文档的.set()需要依赖离线持久化来将写操作加入本地队列，如果没开启，离线时就会直接报错。

你需要在初始化Firestore时显式启用持久化：

import firebase from 'firebase/app';
import 'firebase/firestore';

// 初始化Firebase
const firebaseConfig = {
  // 你的Firebase配置信息
};
firebase.initializeApp(firebaseConfig);

// 启用离线持久化
firebase.firestore().enablePersistence()
  .catch((err) => {
    if (err.code === 'failed-precondition') {
      console.log('无法启用离线持久化：当前应用在多个标签页/窗口打开');
    } else if (err.code === 'unimplemented') {
      console.log('当前设备环境不支持Firestore离线持久化');
    }
  });

注意：启用持久化的代码要放在所有Firestore操作之前，确保初始化完成后再执行读写逻辑。

2. Firebase SDK版本存在Bug #

旧版本的Firebase SDK在React Native离线场景下，处理新文档的.set()可能存在兼容性问题。建议你升级到最新的稳定版：

# 使用npm
npm update firebase

# 使用yarn
yarn upgrade firebase

3. 代码优化与错误处理 #

你的代码里重复编写了Firestore路径，不仅冗余还容易出错，另外.set()没有添加错误捕获，建议优化成更简洁健壮的写法：

// 提取重复的Firestore引用，避免重复编写路径
const targetDocRef = firebase.firestore()
  .collection(this.state.mainCollectionId)
  .doc(this.state.authKey)
  .collection(collectionId.toString())
  .doc(docId);

targetDocRef.get()
  .then(docData => {
    if (!docData.exists) {
      targetDocRef.set({
        id: 1234,
        collectionId: collectionId.toString(),
        authKey: this.state.userDatails.authKey,
        name: this.state.userDatails.name,
        email: this.state.userDatails.email
      })
      .then(() => console.log('文档已离线创建，将在联网后自动同步'))
      .catch(err => console.error('离线创建文档失败：', err));
    }
  })
  .catch(err => console.error('读取文档状态失败：', err));

4. 验证文档路径的合法性 #

虽然其他操作正常，但还是建议检查collectionId和docId是否包含特殊字符（比如空格、斜杠、百分号等），Firestore对文档路径的字符有一定限制，特殊字符可能导致离线写入时的隐性失败。

验证效果 #

启用持久化并升级SDK后，离线时调用.set()创建新文档，Firestore会将操作缓存到本地设备，等设备恢复联网后自动同步到云端。你可以通过firebase.firestore().enablePersistence()的返回结果，确认持久化是否成功启用。

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