Firestore事务：文档存在更新令牌、不存在设默认值失败问题咨询

你遇到的这个场景其实是Firestore里典型的**Upsert（更新或插入）**需求，用事务来实现完全可行，之前失败大概率是没处理好事务内的文档存在性判断和对应的操作逻辑。我给你整理一套靠谱的实现方案，不管是前端Web SDK还是后端Admin SDK都适用。

核心思路 #

事务的本质是原子性操作：在事务函数里先获取目标文档的快照，判断是否存在：

• 若存在：仅更新applicationToken字段，避免覆盖其他已有数据
• 若不存在：一次性写入所有默认字段（姓名、邮箱、令牌等）

完整代码示例（Web SDK） #

假设你是在前端的firebaseLogin方法里调用，这里用JavaScript实现：

async function upsertUserToken(userId, newAppToken, userBasicInfo) {
  const db = firebase.firestore();
  // 用用户UID作为文档ID，确保唯一性
  const userDocRef = db.collection('users').doc(userId);

  try {
    await db.runTransaction(async (transaction) => {
      // 事务内获取文档快照
      const userDocSnap = await transaction.get(userDocRef);

      if (userDocSnap.exists) {
        // 文档已存在：只更新令牌和更新时间
        transaction.update(userDocRef, {
          applicationToken: newAppToken,
          updatedAt: firebase.firestore.FieldValue.serverTimestamp()
        });
      } else {
        // 文档不存在：写入所有默认字段
        const defaultUserFields = {
          ...userBasicInfo, // 传入的姓名、邮箱等登录时获取的信息
          applicationToken: newAppToken,
          createdAt: firebase.firestore.FieldValue.serverTimestamp(),
          updatedAt: firebase.firestore.FieldValue.serverTimestamp(),
          isActive: true, // 其他你需要的默认字段
          // ... 可以根据业务需求添加更多默认值
        };
        transaction.set(userDocRef, defaultUserFields);
      }
    });
    console.log("令牌更新/用户初始化成功");
  } catch (error) {
    console.error("事务执行失败：", error);
    throw error; // 抛出错误让上层的login方法处理
  }
}

// 在你的firebaseLogin方法里调用
async function firebaseLogin() {
  // 假设这里已经通过Facebook登录获取到了用户信息
  const user = await firebase.auth().signInWithPopup(new firebase.auth.FacebookAuthProvider());
  const userId = user.user.uid;
  const newAppToken = "生成的新应用令牌"; // 这里替换成你的令牌生成逻辑
  const userBasicInfo = {
    name: user.user.displayName,
    email: user.user.email,
    avatar: user.user.photoURL
  };

  try {
    await upsertUserToken(userId, newAppToken, userBasicInfo);
    // 登录成功后的后续逻辑，比如跳转到主页
  } catch (error) {
    // 处理错误，比如提示用户登录失败
    alert(`登录失败：${error.message}`);
  }
}

关键注意事项 #

1. 文档ID的选择：一定要用用户的UID作为文档ID，这样能确保每个用户只有一条记录，避免重复创建。
2. 事务的幂等性：Firestore事务会自动重试（比如遇到并发冲突时），所以要用serverTimestamp()这类服务端生成的值，避免客户端重复执行导致数据不一致。
3. 安全规则配置：如果是前端调用，必须确保Firestore的安全规则允许用户创建/更新自己的文档，比如：

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /users/{userId} {
      allow create, update: if request.auth.uid == userId;
    }
  }
}

4. 错误处理：事务失败可能是因为并发冲突、权限不足、网络问题等，一定要捕获错误并给用户友好提示。

为什么之前的事务会失败？ #

大概率是这几个原因：

• 事务内没有正确等待get操作完成就进行判断（比如漏掉了await）
• 文档引用的ID错误（比如用了随机ID而不是用户UID，导致每次都创建新文档）
• 安全规则不允许创建文档（前端没有权限写入）
• 写入默认字段时缺少必要的参数，导致Firestore拒绝写入

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