本文介绍如何在 WooCommerce 中为自定义订单状态（如 change）配置库存回滚逻辑，使其行为类似 cancelled 状态——当订单状态变更为 change 时，自动将订单内所有商品（含变体）的库存数量按购买量等额恢复。
本文介绍如何在 woocommerce 中为自定义订单状态（如 `change`）配置库存自动增加逻辑，使其行为类似 `cancelled` 状态——当订单状态变更为 `change` 时，自动将订单内所有商品（含变体）的库存数量按购买量等额恢复。
在 WooCommerce 开发中，有时需要扩展标准订单生命周期以支持特殊业务场景，例如客户退换货流程中的“换货申请”（change order）。这类订单不走常规取消（cancelled）或完成（completed）路径，而是通过一个自定义状态（如 wc-change）标识——此时需确保系统能自动将已扣减的库存返还，避免库存数据失真。
WooCommerce 提供了高度可扩展的状态变更钩子：woocommerce_order_status_changed。该动作钩子在任意订单状态切换时触发，并传入订单 ID、旧状态、新状态及完整订单对象，是实现此类逻辑的理想入口。
✅ 实现步骤
-
注册自定义订单状态 wc-change（若尚未注册）
首先确保状态已正确添加（通常在主题 functions.php 或插件中）：// 注册 'change' 订单状态（建议使用 'wc-' 前缀） add_filter('woocommerce_register_shop_order_post_statuses', function($statuses) { $statuses['wc-change'] = array( 'label' => _x('Change', 'Order status', 'your-textdomain'), 'public' => true, 'exclude_from_search' => false, 'show_in_admin_all_list' => true, 'show_in_admin_status_list' => true, 'label_count' => _n_noop('Change <span class="count">(%s)</span>', 'Change <span class="count">(%s)</span>', 'your-textdomain') ); return $statuses; }); -
监听状态变更并触发库存增加
当订单状态变为 wc-change 时，调用 WooCommerce 内置函数 wc_increase_stock_levels() —— 该函数会遍历订单所有项（包括简单产品、变体、组合商品），自动按实际购买数量增加对应 SKU 的库存（支持库存管理开启/关闭的产品，并跳过无库存管理的商品）：add_action('woocommerce_order_status_changed', 'handle_change_order_stock_increase', 10, 4); function handle_change_order_stock_increase($order_id, $old_status, $new_status, $order) { // 注意：$new_status 是不含 'wc-' 前缀的简写形式（如 'change' 而非 'wc-change'） if ('change' === $new_status) { wc_increase_stock_levels($order); } }
⚠️ 关键注意事项
- wc_increase_stock_levels() 是 WooCommerce 官方推荐的安全方法，它会自动处理变体库存（variation_id）、库存日志记录（_stock_log 元数据）、库存阈值检查，并兼容多仓库、库存同步等扩展；
- 不要手动遍历 $order->get_items() 并调用 WC_Product::increase_stock()，易遗漏变体逻辑或破坏事务一致性；
- 确保你的自定义状态名与钩子中判断的字符串完全一致（区分大小写，且不含 wc- 前缀）；
- 若需在库存增加后执行额外操作（如发送通知、更新外部系统），请使用 woocommerce_stock_reduced_from_order 或 woocommerce_product_set_stock 等衍生钩子。
✅ 验证效果示例
假设订单 #1234 包含：
- 变体 A102-L（variation_id = 567），购买 1 件 → 原库存 12，下单后变为 11；
- 变体 A108-M（variation_id = 568），购买 2 件 → 原库存 15，下单后变为 13。
当该订单状态由 processing 切换为 change 后，上述代码将自动执行：
✅ A102-L 库存恢复为 11 + 1 = 12
✅ A108-M 库存恢复为 13 + 2 = 15
✅ 后台库存日志中可见 Stock increased by 1 (via change order) 等记录
此方案轻量、健壮、符合 WooCommerce 最佳实践，适用于生产环境。建议将全部代码封装为独立插件以保障主题升级安全性。
