支付成功后无法将订单存入Firestore，成功URL跳转404问题

点击结账按钮跳转至Stripe完成支付，支付成功但成功URL失效，用户被导向404页面。移除try/catch后能在终端打印order内容，但加入Firestore存储逻辑后订单无法存入数据库，相关代码如下：

app.get('/success', async (req, res) => {
     let { order, session_id } = req.query;
 
     try {
         const session = await stripeGateway.checkout.sessions.retrieve(session_id);
         const customer = await stripeGateway.customers.retrieve(session.customer);
 
         let date = new Date();
 
         let orders_collection = collection(db, "orders");
         let docName = `${customer.email}-order-${date.getTime()}`;
 
         setDoc(doc(orders_collection, docName), JSON.parse(order))
         .then(data => {
             res.redirect('/checkout?payment=done')
         })
     } catch {
         res.redirect("/404")
     }     
})

排查步骤 #

• 先抓具体错误日志：当前catch块直接跳404，完全看不到哪里出问题。修改catch块打印错误：

  catch (error) {
      console.error('订单存储失败详情:', error);
      res.redirect("/404")
  }
  

  不管是JSON解析错、Firestore权限问题还是字段不合法，日志里都会明说。

• 验证JSON解析是否正常：移除Firestore逻辑能打印order，但加入后可能order的JSON格式有问题，导致解析失败触发catch。先单独解析并打印：

  const parsedOrder = JSON.parse(order);
  console.log('解析后的订单数据:', parsedOrder);
  

  确认解析结果没有Firestore不支持的类型（比如undefined、函数）。

• 检查Firestore的连接和权限：

  • 确认db实例是否正确初始化，有没有遗漏密钥或项目ID配置；
  • 临时放开Firestore安全规则（仅限测试），验证是不是权限拦截了写入：

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

• 统一异步逻辑写法：当前代码混用async/await和.then()，可能导致Promise错误没被外层catch捕获。改成全await写法：

  await setDoc(doc(orders_collection, docName), JSON.parse(order));
  res.redirect('/checkout?payment=done');
  

  这样setDoc的异常会被try/catch正常捕获，也避免回调嵌套的逻辑混乱。

• 处理文档ID的非法字符：Firestore文档ID不能包含@、.这些符号，customer.email里的@和点会导致创建文档失败。转义处理邮箱：

  const safeEmail = customer.email.replace(/[.@]/g, '_');
  let docName = `${safeEmail}-order-${date.getTime()}`;
  

• 确认Stripe返回的用户信息有效：打印customer对象，检查是否存在email字段，会不会是session.customer无效导致获取不到用户数据：

  console.log('Stripe用户信息:', customer);
  

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