Firebase Stripe扩展未返回Session ID，无法跳转结账页求助

我正在用Firebase Stripe扩展给应用集成支付功能，但在用户子集合添加文档后，没法跳转到结账页面——核心原因是Session ID从未生成。按照教程，目标集合创建文档时应该触发webhook，由扩展创建会话并把Session ID写回文档，但这个流程完全没触发，我拿不到Session ID，不知道该怎么排查。另外我觉得配置是对的，因为在Stripe控制台新建产品时，会自动同步到Firestore数据库里。

代码实现 #

import { collection, getDocs, query, where, addDoc, doc, onSnapshot } from "firebase/firestore";
import getStripe from "./initializeStripe";
import { db } from "./firebase-config";

export async function createCheckoutSession(uid) {

    console.log(uid)
    console.log(db)
    const usersRef = collection(db, "users");
    const q = query(usersRef, where("user_id", "==", uid));
    const querySnapshot = await getDocs(q);
  
    if (querySnapshot.empty) {
      console.log(`User with UID ${uid} not found`);
      return;
    }
  
    // 假设给定UID对应唯一用户文档
    const userDoc = querySnapshot.docs[0];

  // 在用户文档的子集合中创建新的结账会话文档
  const sessionRef = collection(db, "users", userDoc.id, "checkout_sessions");

  const { id: checkoutSessionId } = await addDoc(sessionRef, {
    // 替换为你Stripe产品对应的价格ID
    price: "price_1MtdiVAFJ9qTOX9QC38xlXRZ",
    success_url: 'pizza.com',
    cancel_url: 'google.com',
  });

  const checkoutSessionRef = doc(sessionRef, checkoutSessionId);
  onSnapshot(checkoutSessionRef, async (snap) => {
    console.log(snap.data())
    const { sessionId } = snap.data();
    console.log(snap.data().sessionId)
    if (snap.exists()) {
      const stripe = await getStripe();
      stripe.redirectToCheckout( {sessionId});
    }
  });
}

编辑补充：集合结构截图说明 #

• users集合：显示用户文档包含user_id等字段，结构正常
• checkout_sessions子集合：新创建的会话文档仅包含price、success_url、cancel_url字段，无预期的sessionId字段

排查步骤 #

1. 核对扩展配置 #

• 确认Firebase Stripe扩展的「Checkout sessions collection」配置项是users/{userId}/checkout_sessions，和代码中子集合路径完全一致
• 检查扩展是否被授予Firestore读写users/{userId}/checkout_sessions集合的权限

2. 验证文档字段合法性 #

• 确认price字段是Stripe中有效的价格ID（price_xxx格式），且对应产品状态正常
• success_url和cancel_url必须是带协议头的完整URL（比如https://pizza.com），Stripe不接受无协议的短域名

3. 查看扩展日志 #

• 打开Firebase控制台 → 扩展 → 找到Stripe扩展 → 进入「日志」标签页
• 搜索checkout_sessions相关日志，排查是否有明确错误（比如权限不足、价格ID无效、URL格式错误等）

4. 检查Firestore安全规则 #

• 确保users/{userId}/checkout_sessions集合的安全规则允许扩展服务账号读写，示例规则：

match /users/{userId}/checkout_sessions/{sessionId} {
  allow read, write: if request.auth != null && request.auth.uid == userId;
  // 或者直接允许扩展服务账号访问，需替换为你扩展的服务账号邮箱
  allow write: if request.auth.token.email == "stripe-extensions@your-project.iam.gserviceaccount.com";
}

5. 手动触发测试 #

• 手动在Firestore的users/{userId}/checkout_sessions中创建文档，填入正确的price、带https的success_url和cancel_url
• 等待1-2分钟，查看文档是否被写入sessionId，如果仍未写入，说明扩展触发逻辑存在问题

代码优化建议 #

在onSnapshot监听中增加错误处理，同时避免重复跳转：

onSnapshot(checkoutSessionRef, async (snap) => {
  console.log('当前文档数据:', snap.data());
  const sessionId = snap.data()?.sessionId;
  if (sessionId) {
    const stripe = await getStripe();
    // 跳转前取消监听，防止重复触发
    checkoutSessionRef.onSnapshot(() => {});
    stripe.redirectToCheckout({ sessionId });
  }
}, (error) => {
  console.error('监听文档出错:', error);
});

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