React集成Firebase报错：DocumentReference.set()传入无效数据

这个错误的核心原因是：你传入set()方法的数据里包含Firebase Firestore不支持的字段类型。Firestore只支持有限的原生类型（字符串、数字、布尔值、数组、普通对象、Timestamp、GeoPoint等），而Stripe返回的paymentIntent对象、或者你的basket数据里，大概率存在不符合要求的类型。

具体修复步骤： #

1. 只提取paymentIntent中需要的基础字段，避免直接存整个对象
   Stripe的paymentIntent包含很多内部对象/方法，这些无法被Firestore序列化。只挑你需要的字段（比如金额、支付ID、状态、创建时间）来存储：

   // 提取必要字段，不要直接传paymentIntent
   const paymentInfo = {
     amount: paymentIntent.amount,
     paymentIntentId: paymentIntent.id,
     status: paymentIntent.status
   };
   

2. 将paymentIntent.created转成Firebase Timestamp类型
   paymentIntent.created是Unix时间戳（秒级），需要转成Firestore支持的Timestamp类型：

   import { Timestamp } from "firebase/firestore"; // 或者用firebase.firestore.Timestamp
   
   const orderCreatedAt = Timestamp.fromDate(new Date(paymentIntent.created * 1000));
   

3. 检查并转换basket中的不兼容数据
   购物车数据里可能存在JS Date对象、BigInt、自定义类实例等不支持的类型，需要提前转换：

   // 示例：转换购物车项中的不兼容类型
   const sanitizedBasket = basket.map(item => {
     const sanitizedItem = { ...item };
     // 把JS Date转成Timestamp
     if (sanitizedItem.date instanceof Date) {
       sanitizedItem.date = Timestamp.fromDate(sanitizedItem.date);
     }
     // 把BigInt转成数字（如果数值在安全范围内）或字符串
     if (typeof sanitizedItem.quantity === 'bigint') {
       sanitizedItem.quantity = Number(sanitizedItem.quantity);
     }
     // 移除任何函数、Symbol等无法序列化的属性
     Object.keys(sanitizedItem).forEach(key => {
       if (typeof sanitizedItem[key] === 'function' || typeof sanitizedItem[key] === 'symbol') {
         delete sanitizedItem[key];
       }
     });
     return sanitizedItem;
   });
   

4. 修改写入Firestore的代码
   把处理好的数据传入set()方法：

   await db.collection('users').doc(user.uid).collection('orders').doc(paymentIntent.id).set({
     basket: sanitizedBasket,
     ...paymentInfo,
     created: orderCreatedAt
   });
   

调试技巧： #

• 写入前用console.log('要写入的数据：', { basket, paymentIntent })打印所有字段，检查每个字段的类型，排除Firestore不支持的类型
• 可以先只写入单个字段（比如amount: paymentIntent.amount）测试，逐步排查是哪个字段导致的错误

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