如何列举客户Stripe支付方式并解决Firebase可调用函数返回格式错误

• 后端Firebase可调用云函数未返回序列化的响应数据，不符合Firebase云函数的调用规范
• 未对Stripe返回的支付方式数据做字段过滤，全量返回时可能存在不可序列化的冗余字段
• 缺少基础的参数校验和错误捕获逻辑，异常场景下也会返回非法格式内容

1. 后端云函数修改 #

exports.listPaymentMethods = functions.https.onCall(async (data, context) => {
  try {
    const customerId = data.customer_id;
    // 参数合法性校验
    if (!customerId) {
      throw new functions.https.HttpsError('invalid-argument', '缺少customer_id参数');
    }
    const paymentMethods = await stripe.paymentMethods.list({
      customer: customerId,
      type: "card",
    });
    // 仅过滤前端需要的字段，减少数据量同时避免序列化问题
    const filteredMethods = paymentMethods.data.map(method => ({
      id: method.id, // 后续编辑、删除支付方式时的唯一标识，必备参数
      brand: method.card.brand,
      last4: method.card.last4,
      expMonth: method.card.exp_month,
      expYear: method.card.exp_year
    }))
    // 返回符合规范的序列化结构
    return {
      code: 0,
      message: "success",
      data: filteredMethods
    };
  } catch (err) {
    // 按照Firebase规范抛出可识别的错误类型
    throw new functions.https.HttpsError('internal', err.message);
  }
});

2. 客户端调用代码修改 #

适配后端返回的结构调整解析逻辑：

func listPaymentMethods(customerID: String) {
    FirebaseReferenceManager.functions.httpsCallable("listPaymentMethods").call(["customer_id": customerID]) { (response, error) in
        if let error = error {
            print("failed to list customer's payment methods: \(error.localizedDescription)")
            return
        }
        // 按后端返回结构逐层解析
        guard let resDict = response?.data as? [String: Any],
              let code = resDict["code"] as? Int,
              code == 0,
              let paymentMethods = resDict["data"] as? [[String: Any]] else {
            print("响应格式错误")
            return
        }
        // 拿到paymentMethods数组后可直接渲染到页面
        print(paymentMethods)
    }
}

• 云函数修改后需要重新部署，等待1-2分钟生效后再测试
• 确保传入的customer_id是Stripe后台对应有效的客户ID
• 测试阶段可在Firebase云函数控制台打印日志，排查Stripe返回的原始数据是否正常

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