Shopify配送定制函数如何同步调用Azure函数

Shopify Functions是同步执行的运行环境，不支持任何异步外部请求（包括axios、fetch或Promise调用）——因为函数必须在极短时间内返回配送计算结果，无法等待异步操作完成。你之前尝试的fetch、Promise then/catch方案无效，本质原因是函数会在异步请求发起后直接继续执行，不会等待请求响应。

要解决这个问题，必须调整架构，不能在Shopify Functions内部直接调用Azure函数，以下是可行的替代方案：

方案1：提前通过Webhook计算并存储结果 #

在用户操作触发配送计算之前（比如添加商品到购物车、更新购物车），通过Shopify Webhook将数据发送到Azure函数，计算完成后把结果存储到订单或配送定制的Metafield中。之后Shopify Functions直接读取Metafield的同步数据即可。

修改后的run.js示例：

export function run(input) {
  // 直接读取提前计算好的结果（存储在metafield中）
  const configuration = JSON.parse(
    input?.deliveryCustomization?.metafield?.value ?? "{}"
  );
  // 从configuration中获取Azure函数提前计算好的x值
  const x = configuration.calculatedX ?? 10;

  // 后续同步逻辑...
}

Webhook处理逻辑示例（可部署在Azure或其他服务）：

// 接收Shopify购物车更新Webhook
app.post('/webhooks/cart/update', async (req, res) => {
  const cartData = req.body;
  // 调用Azure函数计算
  const response = await axios.post(functionUrl, cartData, {
    headers: {
      'Content-Type': 'application/json',
      'x-functions-key': functionKey
    }
  });
  // 将计算结果写入对应Metafield
  await shopify.rest.Metafield.create({
    owner_resource: 'cart',
    owner_id: cartData.id,
    key: 'delivery_calculation',
    namespace: 'custom_delivery',
    value: JSON.stringify({ calculatedX: response.data.x }),
    type: 'json'
  });
  res.sendStatus(200);
});

方案2：将Azure函数逻辑迁移到Shopify Functions内部 #

如果Azure函数的逻辑不依赖外部资源（比如简单的计算、规则判断），可以把这部分逻辑直接用同步代码写到Shopify Functions中，完全避免外部调用。

示例：

export function run(input) {
  const configuration = JSON.parse(
    input?.deliveryCustomization?.metafield?.value ?? "{}"
  );
  let x = 10;

  // 原Azure函数的同步逻辑实现
  try {
    // 替换为同步计算逻辑
    const result = calculateX(input);
    x = 5;
  } catch (error) {
    x = 2;
  }

  // 后续逻辑...
}

// 原Azure函数的同步逻辑
function calculateX(input) {
  // 这里写原本Azure函数的计算代码
  return input.someData > 100 ? 5 : 2;
}

关键提醒 #

Shopify Functions的运行环境严格限制了执行时间（通常在100ms以内），任何外部异步调用都会导致函数超时或结果不符合预期，因此必须通过上述架构调整来规避异步操作。

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