WooCommerce：结账时匹配特定商品ID显示提示消息问题排查

原代码的问题分析 #

1. 钩子参数缺失：woocommerce_after_checkout_validation钩子包含$data和$errors两个参数，原函数只声明了$data，无法调用WooCommerce的错误拦截机制来阻止结账。
2. 输出方式错误：直接用echo输出内容在结账验证流程中无效，必须通过WC_Error对象添加错误才能触发提示并拦截结账。
3. 冗余代码无效：$p = wc_get_product( $product_ids );完全多余，wc_get_product()仅支持单个商品ID，传入数组不会返回有效对象。
4. 判断逻辑错误：你尝试的if ( $product_ids === $product->get_id() )是用数组和单个ID做全等比较，永远不会成立。

修正后的代码 #

add_action( 'woocommerce_after_checkout_validation', 'product_specific_checkout_message', 10, 2 );
function product_specific_checkout_message( $data, $errors ) {
    // 指定需要匹配的商品ID（支持主商品ID或变体ID，按需调整）
    $target_product_ids = array( 111342, 111347 );

    // 遍历购物车所有商品
    foreach ( WC()->cart->get_cart() as $cart_item ) {
        // 获取当前商品主ID：若需匹配变体ID，替换为 $cart_item['data']->get_id()
        $current_product_id = $cart_item['product_id'];
        
        // 检查是否匹配目标ID
        if ( in_array( $current_product_id, $target_product_ids ) ) {
            // 添加错误提示，WooCommerce会自动显示并阻止结账
            $errors->add( 'product-specific-error', '该商品需特殊处理，请联系客服后再完成结账！' );
            // 找到匹配项后终止循环，提升效率
            break;
        }
    }
}

代码说明 #

• 钩子参数修正：正确声明$errors参数，这是WooCommerce管理验证错误的核心对象。
• 商品ID获取：$cart_item['product_id']取主商品ID，若要匹配变体ID，改用$cart_item['data']->get_id()即可。
• 错误触发：调用$errors->add()添加错误，第一个参数为自定义错误标识，第二个为显示给用户的提示消息。
• 循环优化：找到匹配商品后用break终止循环，避免不必要的遍历。

额外注意事项 #

• 商品ID建议用数值类型，避免字符串与数值类型不一致导致的匹配失败。
• 若需针对不同商品显示不同提示，可在循环内添加多条件判断，对应输出不同错误消息。

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