Firebase中使用自定义文档ID时，应采用何种方法替代addDoc？

如果你需要使用自定义文档ID，不要使用addDoc方法——因为addDoc的核心作用就是自动生成文档ID并添加数据到集合中。正确的操作步骤如下：

实现步骤 #

1. 创建带自定义ID的文档引用：使用doc()方法，传入集合引用和你指定的自定义ID，生成目标文档的引用对象。
2. 写入数据到文档：调用setDoc()方法，将数据写入这个带自定义ID的文档引用中。

代码示例（JavaScript/TypeScript） #

import { doc, setDoc } from "firebase/firestore";
import { db } from "./your-firebase-config"; // 你的Firebase数据库实例

// 替换为你的集合名称和自定义文档ID
const collectionName = "products";
const customDocId = "prod-001";

// 创建文档引用
const targetDocRef = doc(db, collectionName, customDocId);

// 写入数据
async function addCustomIdDoc() {
  try {
    await setDoc(targetDocRef, {
      productName: "Wireless Headphones",
      price: 99.99,
      inStock: true
    });
    console.log("自定义ID文档写入成功");
  } catch (e) {
    console.error("写入失败：", e);
  }
}

addCustomIdDoc();

补充说明 #

• 如果指定的自定义ID文档已经存在，setDoc()会直接覆盖原有数据。如果需要避免覆盖，可添加merge: true选项实现数据合并：

  await setDoc(targetDocRef, { lastUpdated: new Date() }, { merge: true });
  

• 你可以提前检查文档是否存在，再决定是否写入，避免意外覆盖：

  const docSnap = await getDoc(targetDocRef);
  if (!docSnap.exists()) {
    await setDoc(targetDocRef, { /* 数据 */ });
  } else {
    console.log("该自定义ID的文档已存在");
  }
  

addDoc 方法官方说明（翻译） #

• 将给定数据添加到指定的CollectionReference中，自动为其分配文档ID。
• 参数：
  • reference：要添加此文档的集合引用。
  • data：包含新文档数据的对象。
• 返回值：一个Promise，当文档写入后端后会解析为指向新创建文档的DocumentReference（注意：离线时不会解析）。

类型声明：

export declare function addDoc(reference: CollectionReference, data: WithFieldValue): Promise<DocumentReference>;

辅助方法说明 #

• 返回一个新映射，其中每个键都添加了外部键作为前缀并以点分隔。

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