WooCommerce按配送区域设置不同最小订购量问题排查

原代码的核心问题 #

1. 钩子选择错误：woocommerce_package_rates的作用是修改配送选项费率，并非用于订单验证逻辑，触发时机不对导致验证无法正常生效。
2. 重复提示风险：循环所有配送package会导致同一错误提示被多次添加。
3. 未阻断结账流程：仅添加错误提示但未阻止用户继续结账，体验逻辑不完整。

修正后的代码 #

function check_min_order_amount_by_shipping_zone() {
    // 仅在购物车和结账页面执行逻辑
    if ( ! is_cart() && ! is_checkout() ) return;

    // 获取当前用户的配送地址信息
    $shipping_country = WC()->customer->get_shipping_country();
    $shipping_state = WC()->customer->get_shipping_state();
    $shipping_postcode = WC()->customer->get_shipping_postcode();
    $shipping_city = WC()->customer->get_shipping_city();

    // 构建配送区域查询参数
    $package = array(
        'destination' => array(
            'country'   => $shipping_country,
            'state'     => $shipping_state,
            'postcode'  => $shipping_postcode,
            'city'      => $shipping_city,
        )
    );

    // 获取匹配的配送区域
    $shipping_zone = wc_get_shipping_zone( $package );
    $shipping_zone_id = $shipping_zone->get_id();

    // 按区域ID设置最低订购数量
    switch ( $shipping_zone_id ) {
        case 1:
            $min_order = 5; 
            break;
        case 8:
        case 9:
            $min_order = 15;
            break;
        case 6:
            $min_order = 10; 
            break;
        default:
            $min_order = 0; 
            break;
    }

    // 验证购物车商品数量是否达标
    $cart_item_count = WC()->cart->get_cart_contents_count();
    if ( $min_order > 0 && $cart_item_count < $min_order ) {
        wc_add_notice( sprintf( '你的配送区域最低订购数量为 %s。', $min_order ), 'error' );
        // 结账页验证不通过时，移除结账按钮阻断流程
        if ( is_checkout() ) {
            remove_action( 'woocommerce_proceed_to_checkout', 'woocommerce_button_proceed_to_checkout', 20 );
        }
    }
}
// 在购物车验证和结账提交前触发逻辑
add_action( 'woocommerce_check_cart_items', 'check_min_order_amount_by_shipping_zone', 10 );
add_action( 'woocommerce_checkout_process', 'check_min_order_amount_by_shipping_zone', 10 );

关键修改说明 #

• 更换触发钩子：使用woocommerce_check_cart_items（购物车页面实时验证）和woocommerce_checkout_process（结账提交前校验），确保逻辑在正确时机执行。
• 精准匹配配送区域：通过用户当前配送地址构建查询参数，直接获取对应区域，避免无效循环。
• 简化代码结构：合并ID为8和9的区域配置，减少冗余代码。
• 完善流程阻断：验证不通过时，结账页自动移除结账按钮，强制用户调整购物车商品数量。

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