本文详解如何在 WooCommerce 中为自定义订单状态（如 change）配置库存自动增加逻辑，使其行为类似 cancelled 状态：当订单状态变更为 change 时，自动将订单内所有商品（含变体）的库存按购买数量恢复。
本文详解如何在 woocommerce 中为自定义订单状态（如 `change`）配置库存自动增加逻辑，使其行为类似 `cancelled` 状态：当订单状态变更为 `change` 时，自动将订单内所有商品（含变体）的库存按购买数量恢复。
在 WooCommerce 中，系统原生支持 cancelled 和 refunded 等状态自动释放库存，但若需为自定义订单状态（例如用于处理客户退换货的 "change" 状态）实现相同效果，则需通过钩子手动介入库存管理流程。
✅ 核心原理：监听订单状态变更
WooCommerce 提供了统一的钩子 woocommerce_order_status_changed，它在任何订单状态发生变更时被触发，并传入订单 ID、旧状态、新状态及完整订单对象。我们正是利用该钩子，在检测到新状态为 change 时，调用 WooCommerce 内置函数 wc_increase_stock_levels() 来安全地增加库存。
⚠️ 注意：wc_increase_stock_levels() 是 WooCommerce 官方推荐的库存回滚方法，它会自动区分简单产品、变体产品（如 A102-L）、可库存管理（stock managed）与不可库存管理的产品，并跳过无需处理的商品，确保操作健壮可靠。
? 实现步骤（代码集成）
将以下代码添加至当前启用主题的 functions.php 文件（强烈建议使用子主题），或通过插件方式加载：
add_action('woocommerce_order_status_changed', 'handle_change_order_status_stock_increase', 10, 4);
function handle_change_order_status_stock_increase($order_id, $old_status, $new_status, $order) {
// 确保 $order 是 WC_Order 实例（防止早期钩子中 $order 为空）
if (!$order instanceof WC_Order) {
$order = wc_get_order($order_id);
}
// 仅当新状态为 'change' 时执行库存增加
if ('change' === $new_status && $order) {
wc_increase_stock_levels($order);
// （可选）记录日志便于调试
if (defined('WP_DEBUG') && WP_DEBUG) {
error_log("Stock increased for order #{$order_id} due to status change → 'change'");
}
}
}? 补充说明与最佳实践
-
状态注册前提：请确保你已通过 register_post_status() 正确注册了 wc-change 订单状态（注意 WooCommerce 状态前缀为 wc-）。例如：
function register_wc_change_order_status() { register_post_status('wc-change', array( 'label' => _x('Change', 'Order status', '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>', 'textdomain') )); } add_action('init', 'register_wc_change_order_status'); // 同时添加到下拉菜单（前端/后台） function add_change_to_order_statuses($order_statuses) { $order_statuses['wc-change'] = _x('Change', 'Order status', 'textdomain'); return $order_statuses; } add_filter('wc_order_statuses', 'add_change_to_order_statuses'); 库存精度保障：wc_increase_stock_levels() 会逐项遍历订单中的每个订单项（WC_Order_Item_Product），对启用库存管理的商品精确执行 $product->increase_stock($quantity)，并自动更新 _stock 元字段和缓存，无需手动 SQL 操作。
避免重复执行：该钩子在状态变更时只触发一次，且函数内部已包含状态判断，不会因多次保存订单而重复加库存。
兼容性提示：适用于 WooCommerce 5.0+；若使用旧版，请确认 wc_increase_stock_levels() 函数存在（自 WC 3.0 起稳定可用）。
✅ 效果验证示例
假设订单 #1234 包含：
- 变体 A102-L（当前库存 11，订购 1 件）
- 变体 A108-M（当前库存 13，订购 2 件）
当管理员将订单状态由 processing 改为 change 后：
→ A102-L 库存自动变为 12（11 + 1）
→ A108-M 库存自动变为 15（13 + 2）
完全符合业务预期，且全程无手动干预。
通过本方案，你不仅实现了“change”状态的语义化管理，更赋予其与核心订单生命周期深度集成的库存控制能力——专业、简洁、可维护。
