Next.js API响应遍历问题：打印标签时shipmentId为空

1. 验证API返回的订单数据是否符合预期 #

在调用createSale获取订单数据后，立即打印完整的order_fulfillments数组，确认是否存在且仅有一个元素的shipment_id非空：

const updatedOrder = await createSale(orderId);
console.log('order_fulfillments数组:', updatedOrder.order_fulfillments);

• 检查字段名拼写：确认是shipment_id而非shipmentId或其他变体
• 确认空值类型：判断目标值是null、空字符串""还是undefined，避免判断条件遗漏

2. 修正遍历获取shipment_id的逻辑 #

替换原有遍历逻辑，使用更严谨的判断条件筛选有效shipment_id：

const getValidShipmentId = (order) => {
  // 先校验数组合法性
  if (!order?.order_fulfillments || !Array.isArray(order.order_fulfillments)) {
    console.error('order_fulfillments不存在或不是有效数组');
    return null;
  }
  // 筛选出shipment_id非空的唯一元素
  const validFulfillment = order.order_fulfillments.find(item => {
    // 覆盖null、空字符串、undefined三种空值情况
    return item.shipment_id !== null && item.shipment_id !== '' && typeof item.shipment_id !== 'undefined';
  });
  return validFulfillment?.shipment_id || null;
};

3. 确保异步流程的时序正确性 #

必须等待createSale异步请求完成并返回最新订单数据后，再执行shipment_id的提取操作，避免使用未更新的旧数据：

// 处理打印按钮点击的异步函数
const handlePrintLabel = async (orderId) => {
  // 步骤1：检查并完成订单项履行
  await checkFulfilled(orderId);
  
  // 步骤2：等待createSale返回更新后的完整订单数据
  const updatedOrder = await createSale(orderId);
  
  // 步骤3：提取有效shipment_id
  const shipmentId = getValidShipmentId(updatedOrder);
  
  // 步骤4：调用打印接口
  if (shipmentId) {
    await PrintLabel(shipmentId);
  } else {
    console.error('shipmentId is null, not calling PrintLabel');
    // 可在此添加用户提示，比如弹窗告知履行未完成
  }
};

4. 排查后端API的履行状态逻辑 #

确认createSale接口确实已正确标记履行状态并生成有效shipment_id：

• 直接调用createSale的API地址，传入测试用orderId，查看返回的order_fulfillments是否包含非空的shipment_id
• 若API返回数据中无有效shipment_id，则问题出在后端的shipment预订流程，需排查后端逻辑

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