本文介绍如何在 woocommerce rest api 创建订单时，不依赖本地 product_id，而是通过商品 sku 在目标站点动态查询对应 product_id，实现多环境（如测试/生产）间订单无缝同步。
本文介绍如何在 woocommerce rest api 创建订单时，不依赖本地 product_id，而是通过商品 sku 在目标站点动态查询对应 product_id，实现多环境（如测试/生产）间订单无缝同步。
在跨站同步 WooCommerce 订单的场景中（例如从测试环境推送订单到生产环境），一个常见痛点是：同一商品在不同站点的 product_id 不一致，但 SKU 唯一且保持一致。此时若直接使用源订单中的 product_id 提交 REST API，将导致商品无法识别、订单创建失败或商品错配。
WooCommerce REST API 的 /orders 端点（如 POST /wp-json/wc/v3/orders）仅接受 product_id 字段作为 line_items 的必填关联标识，不支持直接传入 sku。因此，正确做法是：在提交订单前，针对每个订单项，先通过 /products?sku=xxx 接口在目标站点实时查询该 SKU 对应的真实 product_id，再构造合法的 line_items 数组。
以下是完整、健壮的实现方案（含错误处理与性能优化建议）：
✅ 核心逻辑：SKU → 远程 product_id 查询
foreach ( $order->get_items() as $item_id => $item ) {
$quantity = $item->get_quantity();
$product = $item->get_product();
$sku = $product ? $product->get_sku() : '';
if ( ! $sku ) {
error_log( "Warning: Order #{$order_id} item {$item_id} has no SKU. Skipping." );
continue;
}
// 构造远程产品查询 URL（注意：需确保 consumer_key & secret 有 products:read 权限）
$remote_keys = 'consumer_key=ck_xxx&consumer_secret=cs_xxx';
$query_url = "https://live-site.com/wp-json/wc/v3/products?sku=" . urlencode($sku) . "&{$remote_keys}";
$response = wp_remote_get( $query_url, [
'timeout' => 15,
'headers' => [ 'User-Agent' => 'WooCommerce-SKU-Transfer' ]
] );
if ( is_wp_error( $response ) || wp_remote_retrieve_response_code( $response ) !== 200 ) {
error_log( "Failed to fetch product by SKU '{$sku}': " . print_r( $response, true ) );
continue;
}
$products = json_decode( wp_remote_retrieve_body( $response ), true );
if ( empty( $products ) || ! isset( $products[0]['id'] ) ) {
error_log( "No product found for SKU '{$sku}' on remote site." );
continue;
}
$line_items[] = [
'quantity' => (int) $quantity,
'product_id' => (int) $products[0]['id']
];
}⚠️ 关键注意事项
-
权限要求：目标站点的 API key 必须拥有
products:read权限，否则/products?sku=...请求将被拒绝（401/403）。 - SKU 唯一性：WooCommerce 默认允许重复 SKU，务必在目标站点确保 SKU 全局唯一（可通过插件如 Unique SKU 或自定义钩子校验）。
-
性能优化：
- 避免在循环内重复拼接 URL，推荐提前定义
$base_api_url； - 对高频 SKU 可增加轻量级内存缓存（如
wp_cache_set/get），减少重复请求； - 生产环境建议添加请求限流（如每秒 ≤2 次）防止触发 API 限速。
- 避免在循环内重复拼接 URL，推荐提前定义
-
容错处理：必须检查
wp_remote_get返回值、HTTP 状态码、JSON 解析结果及数组结构，避免因单个商品失败导致整个订单同步中断。 -
变体商品：若涉及可变产品（Variable Product），
/products?sku=xxx同样能精准返回对应变体（variation）的id，无需额外处理。
✅ 最终订单提交示例（精简版）
$body = [
'status' => 'processing',
'line_items' => $line_items, // ✅ 已填充远程 product_id
'billing' => [ /* ... */ ],
'shipping' => [ /* ... */ ],
'meta_data' => [ /* ... */ ]
];
$response = wp_remote_post(
"https://live-site.com/wp-json/wc/v3/orders?{$remote_keys}",
[
'headers' => [ 'Content-Type' => 'application/json' ],
'body' => wp_json_encode( $body ),
'timeout' => 30
]
);通过该方案，你即可彻底摆脱 product_id 环境依赖，构建稳定、可扩展的 WooCommerce 多站点订单同步链路。
