使用Stripe Firebase扩展创建订阅时无法获取checkout sessionId

我正尝试使用Stripe Firebase扩展创建订阅，采用JavaScript开发并参考官方指南。指南中的代码示例如下：

// 官方示例代码
// 注释：创建Checkout会话后，Stripe Firebase扩展会在文档中填充sessionId，用于跳转至Checkout页面
// lib/db.js
import firebase from './firebase';
import getStripe from './stripe';

const firestore = firebase.firestore();

export async function createCheckoutSession(uid) {
  const checkoutSessionRef = await firestore
    .collection('users')
    .doc(uid)
    .collection('checkout_sessions')
    .add({
      price: 'price_HLxRKYrVN3CVzy',
      // 不需要优惠码可删除此行
      allow_promotion_codes: true,
      success_url: window.location.origin,
      cancel_url: window.location.origin
    });

  checkoutSessionRef.onSnapshot(async (snap) => {
    const { sessionId } = snap.data();

    if (sessionId) {
      const stripe = await getStripe();

      stripe.redirectToCheckout({ sessionId });
    }
  });
}

我发现该代码风格更偏向Node.js或Next.js，因此编写了自己的代码版本（采用Firebase v9模块化API）：

import { addDoc, doc, onSnapshot, collection } from "firebase/firestore";
import { firestore } from "../../firebase";
import { getStripe } from "./initializeStripe";

export async function createCheckoutSession(uid) {

  const stripe = await getStripe();

  const docRef = await addDoc(collection(firestore, "users", `${uid}`, "checkout_sessions"), {
    price: "PRICE_ID",
    success_url: window.location.origin,
    cancel_url: window.location.origin,
  })

  // 等待扩展写入CheckoutSession信息
  onSnapshot(doc(firestore, "users", `${uid}`, "checkout_sessions", docRef.id), (doc) => {
    console.log("Current data: ", doc.data());
    const { sessionId } = doc.data();
    
    console.log("doc data: ", doc.data());
    stripe.redirectToCheckout({sessionId: "123"});
  });
}

尽管做了这些改动（若能解释改动原因将不胜感激），代码在执行到const { sessionId } = doc.data();之前均能正常运行，但我无法从文档数据中获取到sessionId字段，导致无法创建Checkout Session，恳请提供帮助。

你的代码改动原因解释 #

你的代码基于Firebase v9+模块化API重写，是当前Firebase官方推荐的现代写法，和官方示例的v8命名空间风格差异点：

• 直接导入Firestore的具体方法（addDoc、doc等），而非通过firebase.firestore()链式调用，支持tree-shaking，能减小打包体积。
• 显式导入预初始化的firestore实例，而非每次调用方法时初始化，符合模块化项目的规范。

无法获取sessionId的排查与修复 #

1. 检查扩展基础配置

• 确认Stripe Firebase扩展已正确安装，且扩展配置的Cloud Functions区域与你的Firestore数据库区域完全一致。
• 核对扩展的Checkout Sessions Collection配置项是否为users/{uid}/checkout_sessions，和你代码中的集合路径完全匹配。

2. 修复代码中的潜在问题

• 提前初始化Stripe：你在创建文档前就调用await getStripe()，虽不直接导致sessionId缺失，但建议移到快照回调内，避免不必要的资源加载。
• 未处理快照初始状态：扩展未写入sessionId时，doc.data()可能没有该字段，需加判断避免解构报错。
• 硬编码测试sessionId：你写的stripe.redirectToCheckout({sessionId: "123"})会覆盖真实sessionId，必须替换为获取到的字段值。

修改后的代码：

import { addDoc, onSnapshot, collection } from "firebase/firestore";
import { firestore } from "../../firebase";
import { getStripe } from "./initializeStripe";

export async function createCheckoutSession(uid) {
  const docRef = await addDoc(
    collection(firestore, "users", uid, "checkout_sessions"),
    {
      price: "PRICE_ID", // 替换为你的真实Stripe价格ID
      success_url: window.location.origin,
      cancel_url: window.location.origin,
      // 需要优惠码可添加此行
      allow_promotion_codes: true
    }
  );

  // 监听文档变化，等待扩展写入sessionId
  const unsubscribe = onSnapshot(docRef, async (snap) => {
    const data = snap.data();
    if (data?.sessionId) {
      const stripe = await getStripe();
      stripe.redirectToCheckout({ sessionId: data.sessionId });
      // 跳转后取消监听，避免重复触发
      unsubscribe();
    }
  });
}

3. 检查Firestore权限与文档状态

• 确认扩展的服务账号拥有users/{uid}/checkout_sessions集合的读写权限，否则无法写入sessionId。
• 直接到Firebase控制台查看对应路径下的文档：
  • 若文档存在但无sessionId，查看扩展日志（Firebase控制台 -> 扩展 -> 你的Stripe扩展 -> 日志）排查错误。
  • 若文档不存在，检查uid是否正确、集合路径是否拼写错误。

4. 验证Stripe价格ID有效性

确保填写的PRICE_ID是Stripe后台存在的有效ID（格式类似price_xxxxxx），无效ID会导致扩展无法创建Checkout Session，自然不会写入sessionId。

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