NextJS应用无法跳转至Stripe结账页面问题求助

问题详情 #

使用NextJS开发的电商应用无法跳转至Stripe结账页面，报错信息如下：

IntegrationError: stripe.redirectToCheckout: You must provide one of lineItems, items, or sessionId.

错误截图：

仓库地址：https://github.com/sPreet247/ecommerce

解决方法 #

1. 核对redirectToCheckout调用参数 #

报错明确说明调用stripe.redirectToCheckout()时缺少必填参数，必须传入lineItems、items或sessionId三者之一。以下是三种正确调用方式：

• 推荐：使用服务端生成的sessionId
  先通过NextJS API路由创建Stripe结账会话，再将会话ID传给前端调用：

  // 前端调用示例
  const { error } = await stripe.redirectToCheckout({
    sessionId: '从API路由获取的会话ID'
  });
  

• 客户端直接传入商品信息（lineItems）

  const { error } = await stripe.redirectToCheckout({
    lineItems: [
      { price: 'Stripe后台创建的价格ID', quantity: 1 }
    ],
    mode: 'payment', // 根据业务选payment/subscription/setup
    successUrl: 'https://你的域名.com/success',
    cancelUrl: 'https://你的域名.com/cancel',
  });
  

• 旧版参数items（不推荐，建议替换为lineItems）

  const { error } = await stripe.redirectToCheckout({
    items: [
      { sku: '商品SKU_ID', quantity: 1 }
    ],
    successUrl: 'https://你的域名.com/success',
    cancelUrl: 'https://你的域名.com/cancel',
  });
  

2. 排查参数缺失原因 #

• 若使用sessionId：检查API路由是否正确生成并返回会话ID，前端是否正确接收该ID并传入redirectToCheckout。
• 若使用lineItems/items：确认价格ID/SKU ID有效、商品数量大于0，同时mode（lineItems模式必填）、successUrl、cancelUrl等参数配置完整。

3. 结合仓库代码定位问题 #

查看仓库中处理结账逻辑的文件（比如pages/api/checkout.js、前端结账按钮组件），确认调用redirectToCheckout时是否漏传了必填参数。

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