WooCommerce限制用户购买免费商品方法

本文提供了一套无需插件的 WooCommerce 原生解决方案，精准实现“每人限领一件”免费商品（如赠品、试用装）的限购逻辑——无论用户是否登录，系统均能通过用户ID或结账邮箱智能识别唯一身份，并严格校验其是否已成功支付过同类别商品，有效杜绝重复领取；代码健壮兼容访客与注册用户、支持多语言订单状态、兼顾数据库性能与缓存环境，是电商运营中限免活动落地的可靠实践范本。

本文提供一套健壮的 WooCommerce 解决方案，通过自定义钩子与数据库查询，实现对登录用户和未登录访客的统一限购逻辑——确保每个唯一身份（用户 ID 或邮箱）在指定产品分类（如 `free-giveaway`）中最多仅能成功下单一次，适用于零售价赠品、限免活动等场景。

在 WooCommerce 商城中，常需为促销或公益类活动设置「每人限领一件」规则（例如免费赠品、限时试用装），且要求支持未注册访客（Guest）参与。此时，仅依赖 wc_customer_bought_product() 无法满足需求——该函数内部强制校验用户 ID，对未登录用户始终返回 false，导致限购失效。

以下方案通过增强型 has_bought() 辅助函数，智能区分身份类型：对已登录用户使用 user_id 匹配订单；对访客则回退至 billing_email（或通用 email）字段进行订单归属判定，并严格筛选已支付订单（wc_get_is_paid_statuses()），确保逻辑准确、安全可靠。

✅ 完整可部署代码（推荐放入子主题 functions.php）

// 主过滤器：添加到购物车前执行限购检查
add_filter( 'woocommerce_add_to_cart_validation', 'filter_woocommerce_add_to_cart_validation', 10, 5 );
function filter_woocommerce_add_to_cart_validation( $passed, $product_id, $quantity, $variation_id = null, $variations = null ) {
    // 【配置】需限制的 WooCommerce 分类 slug（支持多个）
    $restricted_categories = array( 'free-giveaway', 'limited-offer' );

    // 仅对目标分类内的商品启用检查
    if ( ! $passed || ! has_term( $restricted_categories, 'product_cat', $product_id ) ) {
        return $passed;
    }

    // 尝试获取当前会话的唯一标识符（优先用户ID，其次邮箱）
    $identity_value = '';
    if ( is_user_logged_in() ) {
        $identity_value = get_current_user_id();
    } else {
        // 访客：尝试从 WC_Customer 获取填写的邮箱（含结账页预填值）
        $identity_value = WC()->customer->get_billing_email();
        if ( empty( $identity_value ) ) {
            $identity_value = WC()->customer->get_email(); // 回退至 session email（如结账表单暂存）
        }
    }

    // 若成功获取有效标识，执行已购检测
    if ( ! empty( $identity_value ) && has_bought( $identity_value ) ) {
        wc_add_notice(
            __( '您已成功领取过本类商品，感谢支持！每位用户限领一次。', 'woocommerce' ),
            'error'
        );
        $passed = false;
    }

    return $passed;
}

// 【核心】跨身份类型订单查询函数（兼容用户ID与邮箱）
function has_bought( $value = 0 ) {
    global $wpdb;

    // 输入校验：空值或非法类型直接拒绝
    if ( empty( $value ) ) {
        return false;
    }

    // 区分匹配方式：数字 → 用户ID；字符串 → 邮箱
    if ( is_numeric( $value ) && (int) $value > 0 ) {
        $meta_key   = '_customer_user';
        $meta_value = (int) $value;
    } else {
        $meta_key   = '_billing_email';
        $meta_value = sanitize_email( (string) $value );
    }

    // 获取所有“已支付”订单状态（兼容多语言/自定义状态）
    $paid_statuses = wc_get_is_paid_statuses();
    $status_placeholders = array_fill(0, count($paid_statuses), '%s');
    $status_in_clause = implode(', ', $status_placeholders);

    $count = $wpdb->get_var( $wpdb->prepare(
        "SELECT COUNT(p.ID)
         FROM {$wpdb->posts} AS p
         INNER JOIN {$wpdb->postmeta} AS pm ON p.ID = pm.post_id
         WHERE p.post_type = 'shop_order'
           AND p.post_status IN ({$status_in_clause})
           AND pm.meta_key = %s
           AND pm.meta_value = %s
         LIMIT 1",
        array_merge( $paid_statuses, array( $meta_key, $meta_value ) )
    ) );

    return (int) $count > 0;
}

⚠️ 关键注意事项

• 邮箱可靠性前提：访客限购依赖用户在结账时填写的真实邮箱。若用户频繁更换邮箱或使用临时邮箱，将绕过限制——此为无账号模式的固有边界，不可完全规避。
• 订单状态精准性：has_bought() 严格限定于 wc_get_is_paid_statuses() 返回的状态（如 wc-completed, wc-processing），避免草稿、待付款等无效订单干扰判断。
• 性能优化建议：该查询已加 LIMIT 1 且使用索引字段（postmeta.meta_key + meta_value），在万级订单量下仍保持高效；如站点规模极大，可考虑增加数据库索引：

  CREATE INDEX idx_shop_order_paid_email ON wp_postmeta (meta_key, meta_value) 
  WHERE post_id IN (SELECT ID FROM wp_posts WHERE post_type='shop_order' AND post_status LIKE 'wc-%');

• 与缓存兼容性：代码运行于 PHP 请求生命周期内，不依赖页面缓存，与主流对象缓存（Redis/Memcached）及 CDN 兼容。

✅ 效果验证方式

1. 清空购物车，以访客身份将 free-giveaway 分类下任意商品加入购物车并完成支付；
2. 再次访问同一商品页 → 点击“加入购物车”时应立即显示错误提示；
3. 切换浏览器或使用隐私窗口重试 → 提示依旧生效（因基于邮箱绑定）；
4. 使用不同邮箱或登录另一账户 → 可正常购买，验证隔离性。

此方案兼顾安全性、兼容性与可维护性，无需插件即可落地，是 WooCommerce 零售价赠品场景的生产级实践范本。

终于介绍完啦！小伙伴们，这篇关于《WooCommerce限制用户购买免费商品方法》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！