如何在Firebase中关联不同集合的两个文档

在Firebase Firestore中，关联不同集合的文档主要有以下几种常用实现方式，每种方式适用于不同的业务场景：

1. 使用文档引用（Document Reference）关联 #

这是Firestore官方推荐的关联方式，通过在一个文档中直接存储另一个文档的引用对象来建立关联。

存储关联引用 #

假设有users和orders两个集合，在orders文档中存储下单用户的文档引用：

// 获取目标用户的文档引用
const userRef = db.collection('users').doc('user_123');

// 创建订单文档并关联用户
await db.collection('orders').doc('order_456').set({
  orderId: 'order_456',
  total: 129.9,
  userRef: userRef // 直接存储文档引用对象
});

获取关联文档 #

通过存储的引用直接查询关联的文档：

// 先获取订单文档
const orderDoc = await db.collection('orders').doc('order_456').get();
if (orderDoc.exists) {
  const orderData = orderDoc.data();
  // 通过引用获取关联的用户文档
  const userDoc = await orderData.userRef.get();
  if (userDoc.exists) {
    console.log('关联用户信息：', userDoc.data());
  }
}

优势：保持数据一致性，用户文档更新后，通过引用获取的始终是最新数据；无需手动维护ID匹配。

2. 存储文档ID手动关联 #

如果不需要实时同步或更灵活的数据结构，可以直接存储关联文档的ID，后续手动构造查询。

存储文档ID #

await db.collection('orders').doc('order_456').set({
  orderId: 'order_456',
  total: 129.9,
  userId: 'user_123' // 仅存储用户文档的ID
});

获取关联文档 #

通过存储的ID主动查询目标集合的文档：

const orderDoc = await db.collection('orders').doc('order_456').get();
if (orderDoc.exists) {
  const orderData = orderDoc.data();
  // 通过ID查询用户文档
  const userDoc = await db.collection('users').doc(orderData.userId).get();
  if (userDoc.exists) {
    console.log('关联用户信息：', userDoc.data());
  }
}

优势：数据结构更轻量化，适合对性能要求较高且数据更新频率低的场景；缺点：需要手动保证ID的正确性，数据更新时无法自动同步。

3. 嵌入式关联（嵌套文档） #

如果关联的数据是从属关系且不需要单独维护，可以直接将目标文档的内容嵌入到当前文档中。

嵌入关联数据 #

// 先获取用户数据
const userDoc = await db.collection('users').doc('user_123').get();
if (userDoc.exists) {
  await db.collection('orders').doc('order_456').set({
    orderId: 'order_456',
    total: 129.9,
    userInfo: userDoc.data() // 将用户数据直接嵌入订单文档
  });
}

优势：一次查询即可获取所有关联数据，减少网络请求；缺点：用户信息更新时，所有嵌入了该用户数据的订单文档都需要手动更新，容易出现数据不一致。

4. 云函数自动维护关联 #

如果需要在关联数据更新时自动同步，可以借助Firebase云函数实现触发式更新。

示例：用户信息更新时同步订单中的用户数据 #

exports.syncUserToOrders = functions.firestore
  .document('users/{userId}')
  .onUpdate(async (change, context) => {
    const updatedUser = change.after.data();
    const userId = context.params.userId;

    // 查询所有关联该用户的订单
    const ordersQuery = db.collection('orders').where('userId', '==', userId);
    const ordersSnapshot = await ordersQuery.get();

    // 批量更新订单中的用户信息
    const batch = db.batch();
    ordersSnapshot.forEach(doc => {
      batch.update(doc.ref, { userInfo: updatedUser });
    });

    return batch.commit();
  });

适用场景：需要自动保持关联数据一致性的业务场景；注意控制云函数的执行频率，避免不必要的资源消耗。

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