如何在Firebase Firestore中添加新字段并避免数据覆盖？

你的问题核心是每次提交都在修改同一个board/items文档的顶层字段，即使使用{merge: true}，也只是合并该文档的现有字段，而非添加新的产品条目。要在目标位置添加同结构的新产品，需调整数据存储结构与写入逻辑，以下是两种可行方案：

方案一：用数组存储所有产品（适合小数量产品场景） #

将所有产品放在board/items文档的一个数组字段中，每次提交时向数组追加新产品：

修改setBoard函数如下：

const setBoard = async () => {
  // 构建标准化的产品对象
  const newProduct = {
    id: uuidv4(),
    imageUrl: imageUrl,
    name: name,
    price: price,
    category: category,
    size: {
      default: {
        small: size.includes("s") ? "s" : undefined,
        medium: size.includes("m") ? "m" : undefined,
        large: size.includes("l") ? "l" : undefined,
        extralarge: size.includes("xl") ? "xl" : undefined,
        doubleextralarge: size.includes("xxl") ? "xxl" : undefined,
      },
    },
    description: description,
  };

  // 用updateDoc结合arrayUnion追加新产品（自动去重）
  await updateDoc(doc(board, "items"), {
    products: arrayUnion(newProduct)
  });
};

若需要允许重复提交相同产品，可改为先获取现有数组再手动追加：

const docRef = doc(board, "items");
const docSnap = await getDoc(docRef);
let products = docSnap.exists() ? (docSnap.data().products || []) : [];
products.push(newProduct);
await setDoc(docRef, { products }, { merge: true });

方案二：使用子集合存储产品（Firestore最佳实践，适合大量产品场景） #

放弃单文档存储多产品的方式，改为创建board/items/products子集合，每个产品作为独立文档存储，查询、修改单个产品更高效，还能规避单文档1MB的容量限制：

修改setBoard函数如下：

// 指向products子集合
const productsCollection = collection(db, "board", "items", "products");

const setBoard = async () => {
  // 在子集合中添加新文档（可使用uuid作为文档ID，或让Firestore自动生成）
  await addDoc(productsCollection, {
    imageUrl: imageUrl,
    name: name,
    price: price,
    category: category,
    size: {
      default: {
        small: size.includes("s") ? "s" : undefined,
        medium: size.includes("m") ? "m" : undefined,
        large: size.includes("l") ? "l" : undefined,
        extralarge: size.includes("xl") ? "xl" : undefined,
        doubleextralarge: size.includes("xxl") ? "xxl" : undefined,
      },
    },
    description: description,
  });
};

额外优化：修复尺寸字段逻辑 #

当前代码中size.includes("s") === true && "s"会在不包含对应尺寸时生成false值，建议改为只保留存在的尺寸，避免存储无效数据：

size: {
  default: {
    ...(size.includes("s") && { small: "s" }),
    ...(size.includes("m") && { medium: "m" }),
    ...(size.includes("l") && { large: "l" }),
    ...(size.includes("xl") && { extralarge: "xl" }),
    ...(size.includes("xxl") && { doubleextralarge: "xxl" }),
  },
},

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