WooCommerce订单金额为0时自动修改订单状态为已完成问题求助

原有代码不符合预期的原因 #

你之前使用的代码逻辑是针对虚拟、可下载、预售类商品的状态修改规则，没有单独针对「订单总金额为0」这个核心条件做判断，所以无法匹配你的需求。

核心实现思路 #

• 选择WooCommerce原生订单钩子触发逻辑，避免和系统自带的订单流程冲突
• 精准判断订单最终实付总金额是否为0，排除商品原价总和、未计算折扣的错误判断场景
• 增加状态修改前置校验，仅针对待支付、待处理、搁置状态的订单做修改，避免误操作已取消、已退款的异常订单
• 修改状态后添加专属订单备注，方便后续问题排查

可用实现代码 #

将以下代码添加到站点当前使用主题的functions.php文件末尾，或自定义功能插件的代码文件中即可生效：

// 0元订单自动标记为已完成
add_action( 'woocommerce_new_order', 'auto_complete_zero_total_order', 10, 1 );
add_action( 'woocommerce_order_status_pending', 'auto_complete_zero_total_order', 10, 1 );
add_action( 'woocommerce_order_status_processing', 'auto_complete_zero_total_order', 10, 1 );
add_action( 'woocommerce_order_status_on-hold', 'auto_complete_zero_total_order', 10, 1 );

function auto_complete_zero_total_order( $order_id ) {
    if ( ! $order_id ) return;
    $order = wc_get_order( $order_id );
    
    // 仅处理总金额为0的订单
    if ( $order->get_total() == 0 ) {
        // 仅修改未完成状态的订单
        if ( in_array( $order->get_status(), [ 'pending', 'processing', 'on-hold' ] ) ) {
            $order->update_status( 'completed', '系统自动标记0元订单为已完成' );
        }
    }
}

测试注意事项 #

• 代码部署后建议先创建测试0元订单验证逻辑，确认正常后再正式使用
• 如果站点启用了页面缓存、对象缓存插件，修改代码后需要清理缓存再测试
• 若需要覆盖手动后台创建的0元订单，该逻辑同样适用

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