使用Commerce JS+NextJS开发电商支付时提示库存不足报错如何解决？

Requested quantity is not available报错属于Commerce JS的库存校验拦截，和你提交的orderData结构无关，核心原因是你下单的商品item_7RyWOwmK5nEa2V的可用库存小于你提交的购买数量，按以下步骤排查即可：

• 确认对应商品的实际库存：调用商品查询接口commerce.products.retrieve(对应的产品ID)，查看返回值中inventory.available字段，确认是否确实小于1
• 排查库存临时锁定：Commerce JS默认会对进入 checkout 流程的商品做15-30分钟的库存锁定，如果你之前测试时生成过该商品的checkout token但未完成/取消订单，会导致库存被占用，可进入Commerce JS后台「Inventory」板块手动释放锁定库存
• 校验line item ID正确性：不要硬编码item_7RyWOwmK5nEa2V这个条目ID，要从当前有效的checkout token的line_items字段动态取值，避免ID和实际购物车商品不匹配
• 确认checkout token有效性：不要使用生成超过5分钟的旧checkout token，商品库存、配送规则更新后旧token的校验逻辑会失效，生成订单前要重新拉取最新的checkout token
• 临时校验测试：如果确认库存充足仍报错，可进入Commerce JS后台「Settings > Inventory」，暂时关闭「Reserve inventory for checkouts」选项后测试下单，排查是否是库存锁定规则导致的误拦截

代码优化建议 #

不要硬编码line_items字段，改为从checkout token动态生成：

// 先基于当前购物车生成最新的checkout token
const checkoutToken = await commerce.checkout.generateToken(cart.id, { type: 'cart' });

const orderData = {
  // 动态生成line_items参数
  line_items: checkoutToken.line_items.reduce((res, item) => {
    res[item.id] = { quantity: item.quantity };
    return res;
  }, {}),
  customer: {
    firstname: 'John',
    lastname: 'Doe',
    email: 'john.doe@example.com'
  },
  shipping: {
    name: 'John Doe',
    street: '123 Fake St',
    town_city: 'San Francisco',
    county_state: 'US-CA',
    postal_zip_code: '94103',
    country: 'US'
  },
  fulfillment: {
    shipping_method: 'ship_7RyWOwmK5nEa2V'
  },
  billing: {
    name: 'John Doe',
    street: '234 Fake St',
    town_city: 'San Francisco',
    county_state: 'US-CA',
    postal_zip_code: '94103',
    country: 'US'
  },
  payment: {
    gateway: 'stripe',
    stripe: {
      payment_method_id: paymentMethod.id,
    },
  }
}

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