如何重新同步WooCommerce HPOS中已同步后失配的历史订单？

步骤1：临时开启兼容模式 #

进入WooCommerce > 设置 > 高级 > 功能页面，勾选启用兼容模式（将订单同步到posts表）并保存设置。这一步会启动双向同步机制，确保后续操作中两边的数据更新能互相传递。

步骤2：触发手动同步（两种方式任选其一） #

方式一：使用WooCommerce内置工具

到WooCommerce > 状态 > 工具页面，找到HPOS 订单同步工具，点击立即运行。该工具会自动扫描所有订单，对比HPOS表（wc_orders、wc_order_meta）与post/postmeta表的差异，自动同步失配的数据。

方式二：代码触发同步（适合有开发基础的用户）

在当前主题的functions.php文件中添加以下代码，访问任意前端页面后删除该代码即可：

add_action('init', 'sync_hpos_postmeta_mismatch');
function sync_hpos_postmeta_mismatch() {
    if (!current_user_can('manage_woocommerce')) return;
    
    // 获取所有订单
    $orders = wc_get_orders(array(
        'limit' => -1,
        'type' => 'shop_order',
    ));
    
    foreach ($orders as $order) {
        // 触发订单保存操作，自动同步postmeta到HPOS
        $order->save();
        // 若需反向同步（HPOS数据到postmeta），可取消下方两行注释
        // $order->set_object_read(true);
        // $order->save_meta_data();
    }
}

注意：订单量较大的站点建议分批处理，避免出现超时报错。

步骤3：验证同步结果 #

找几个之前postmeta有更新的订单，对比wc_orders/wc_order_meta和post/postmeta表的字段值，确认两边数据一致。也可以编辑一个订单修改备注等字段，保存后检查两边是否同步更新。

步骤4：按需关闭兼容模式 #

确认所有数据对齐后，若不需要长期保持双向同步，回到WooCommerce > 设置 > 高级 > 功能页面，取消勾选兼容模式并保存设置即可。

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