WooCommerce产品SKU补零至13位：前端搜索失效求助

问题根源 #

你的代码已实现产品保存/更新时将SKU补全为左侧补零的13位格式，但前端搜索无法找到产品的核心原因是：WooCommerce默认搜索直接使用用户输入的原始SKU值，与数据库中存储的13位标准化SKU格式不匹配，导致查询无法命中目标产品。

解决方案 #

需要同步调整搜索逻辑，将用户输入的SKU按相同规则标准化为13位后再执行匹配，确保搜索条件与存储的SKU格式统一。以下是完整优化代码：

// 标准化SKU为13位数字，左侧补零
function ensure_13_digit_sku($sku) {
    // 可选：过滤非数字字符，确保SKU为纯数字
    $sku = preg_replace('/[^0-9]/', '', $sku);
    return str_pad($sku, 13, '0', STR_PAD_LEFT);
}

// 产品保存/更新时自动标准化SKU
function ensure_sku_length_on_save($post_id, $post, $update) {
    // 跳过自动保存和修订版本，避免无效操作
    if (wp_is_post_autosave($post_id) || wp_is_post_revision($post_id)) {
        return;
    }
    
    if ($post->post_type !== 'product') {
        return;
    }
    
    $original_sku = get_post_meta($post_id, '_sku', true);
    $processed_sku = ensure_13_digit_sku($original_sku);
    
    // 仅当SKU有变化时更新，减少数据库交互
    if ($processed_sku !== $original_sku) {
        update_post_meta($post_id, '_sku', $processed_sku);
    }
}
add_action('save_post', 'ensure_sku_length_on_save', 10, 3);

// 调整WooCommerce搜索逻辑，适配标准化SKU
function filter_woocommerce_product_search_query($query, $query_vars) {
    global $wpdb;
    
    // 仅处理产品搜索且存在搜索关键词的场景
    if (empty($query_vars['s']) || $query_vars['post_type'] !== 'product') {
        return $query;
    }
    
    $search_term = $query_vars['s'];
    // 将用户输入的搜索词标准化为13位SKU
    $processed_search_sku = ensure_13_digit_sku($search_term);
    
    // 向搜索查询中添加SKU精确匹配条件
    $query .= $wpdb->prepare("
        OR (
            {$wpdb->postmeta}.meta_key = '_sku'
            AND {$wpdb->postmeta}.meta_value = %s
        )
    ", $processed_search_sku);
    
    return $query;
}
add_filter('woocommerce_product_search_query', 'filter_woocommerce_product_search_query', 10, 2);

代码说明 #

1. SKU标准化函数：统一处理SKU格式，可选过滤非数字字符确保纯数字格式，再通过str_pad实现左侧补零到13位。
2. 保存逻辑优化：增加自动保存/修订版本判断，避免无效更新；仅当SKU实际变化时执行数据库更新，提升性能。
3. 搜索适配逻辑：拦截WooCommerce产品搜索查询，将用户输入的关键词标准化为13位SKU后，添加精确匹配条件，确保搜索结果与存储的SKU完全对应。

内容的提问来源于stack exchange，提问作者Jeriss Cloud Center