无法向Firebase数据库添加数据：setDoc无效，addDoc抛出异常

核心原因 #

addDoc的报错已经明确指向问题：Firestore不支持直接存储Firebase Storage的Reference自定义对象，你传入的Image字段是Storage的文件引用，而非Firestore可识别的基础数据类型（字符串、数字、布尔值等）。

至于setDoc无报错但未写入数据，本质是同一问题——Firestore遇到不支持的字段值时，会静默终止写入操作，不会抛出异常，导致数据未成功保存。

解决方案 #

需要将Storage的Reference转换为Firestore兼容的格式，推荐两种常用方式：

1. 存储文件的公开下载URL #

先通过getDownloadURL获取文件的可访问链接，再将URL字符串存入Firestore：

// 假设已获取到Storage文件引用storageRef
const downloadURL = await getDownloadURL(storageRef);

// 写入数据时使用downloadURL作为Image字段值
await addDoc(collection(db, "items"), {
  Image: downloadURL,
  Name: "商品名称",
  Price: 99.99
});

2. 存储文件的Storage路径 #

如果不需要直接访问链接，也可以存储文件在Storage中的路径字符串，后续需要时再重新构建Reference：

// 获取Storage文件的完整路径
const filePath = storageRef.fullPath;

// 写入数据时使用filePath作为Image字段值
await addDoc(collection(db, "items"), {
  Image: filePath,
  Name: "商品名称",
  Price: 99.99
});

额外验证点 #

• 确认Firestore权限规则确实配置为允许读写（测试环境可使用如下规则）：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /{document=**} {
        allow read, write: if true;
      }
    }
  }
  

• 检查setDoc调用是否指定了正确的文档ID，避免因路径错误导致写入失败：

  // 正确的setDoc调用示例（指定文档ID或自动生成）
  await setDoc(doc(db, "items", "your-doc-id"), {
    Image: downloadURL,
    Name: "商品名称",
    Price: 99.99
  });
  

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