Swift开发：使用Firebase Firestore实现店铺结账的技术疑问

核心解决思路：利用Firestore写入Promise的服务器确认机制 #

Firestore的addDoc()/setDoc()方法返回的Promise，仅在服务器端成功写入文档后才会resolve——本地持久化只是离线缓存，在线状态下Promise的完成就是明确的服务器同步成功信号。完全可以基于这个机制触发后续流程，不需要直接改用Cloud Functions。

具体结账流程实现步骤 #

1. 创建订单并等待服务器确认
   调用Firestore写入方法，通过Promise的then/await确认服务器写入成功，失败则直接抛出错误提示用户：

// 示例：用async/await处理订单写入
try {
  // 创建订单条目，设置初始状态为pending
  const orderDocRef = await addDoc(collection(db, 'orders'), {
    userId: currentUser.uid,
    status: 'pending',
    totalAmount: 9.99,
    createdAt: new Date(),
    // 其他订单必要字段：收件信息、明信片规格等
  });
  const orderId = orderDocRef.id;
  // 到这里，订单已成功写入服务器，继续下一步
  await uploadPostcardImage(orderId);
  await initiateBraintreePayment(orderId);
} catch (error) {
  // 服务器写入失败（权限问题、字段错误等），展示错误给用户
  showError('订单创建失败，请重试：' + error.message);
}

2. 上传明信片图片到Cloud Storage
   用订单ID作为图片存储路径，确保订单与图片关联，上传完成后更新订单文档的图片URL：

async function uploadPostcardImage(orderId) {
  const file = document.getElementById('postcard-image').files[0];
  const storageRef = ref(storage, `orders/${orderId}/postcard.jpg`);
  await uploadBytes(storageRef, file);
  // 获取图片下载URL并更新订单
  const downloadURL = await getDownloadURL(storageRef);
  await updateDoc(doc(db, 'orders', orderId), {
    postcardImageUrl: downloadURL,
    status: 'image_uploaded'
  });
}

3. 启动Braintree支付流程
   仅在订单和图片都处理完成后，初始化支付。支付成功/失败后更新订单状态：

async function initiateBraintreePayment(orderId) {
  // 初始化Braintree客户端（省略具体初始化代码）
  const paymentResult = await braintree.requestPayment({
    amount: 9.99,
    // 其他支付参数
  });

  if (paymentResult.success) {
    // 支付成功，更新订单状态为paid
    await updateDoc(doc(db, 'orders', orderId), {
      status: 'paid',
      paymentId: paymentResult.transactionId,
      paidAt: new Date()
    });
    showSuccess('支付成功，我们将尽快为您印刷发货！');
  } else {
    // 支付失败，更新订单状态为failed
    await updateDoc(doc(db, 'orders', orderId), {
      status: 'failed',
      paymentError: paymentResult.message
    });
    showError('支付失败：' + paymentResult.message);
  }
}

Cloud Functions的辅助作用（非必需，但建议使用） #

不需要用Cloud Functions替代前端流程，但可以用它做后端保障：

• 订单字段校验：创建Firestore触发器，当订单文档创建时，校验字段合法性（比如金额是否符合规则、收件信息是否完整），非法则直接删除文档并记录日志。
• 支付结果校验：配置Braintree的webhook，当支付状态变更时触发Cloud Functions，更新订单状态——避免前端直接修改订单状态，防止恶意篡改。
• 图片自动化处理：创建Storage触发器，当图片上传完成后，自动生成缩略图、压缩图片或验证图片格式/大小。

离线场景处理建议 #

如果用户离线时尝试下单，Firestore的写入Promise会处于pending状态，此时可以：

• 检测网络状态，离线时提示用户“当前网络不可用，无法完成下单，请稍后重试”，不允许进入支付步骤。
• 允许用户保存订单草稿到本地，等网络恢复后再自动提交并完成后续流程。

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