优化WooCommerce后台按SKU/名称搜索产品的SQL查询性能

核心问题分析 #

你的慢查询核心瓶颈在于：

• 对post_content（大段HTML产品描述）执行模糊匹配，这类大字段的LIKE '%关键词%'查询会占用大量数据库资源
• 冗余搜索了post_excerpt字段，而你实际仅需按产品标题和SKU检索

以下是直接修改主题functions.php的代码方案，完全定制搜索逻辑，剔除不必要的查询字段：

代码实现 #

将以下代码添加到主题functions.php文件末尾：

// 定制WooCommerce后台产品搜索的关联语句（保留必要的SKU关联）
add_filter('woocommerce_product_admin_search_join', 'custom_product_search_join');
function custom_product_search_join($join) {
    global $wpdb;
    // 仅保留变体产品与父产品SKU的关联关系
    $join = "LEFT JOIN {$wpdb->prefix}wc_product_meta_lookup wc_product_meta_lookup ON {$wpdb->posts}.ID = wc_product_meta_lookup.product_id
LEFT JOIN {$wpdb->prefix}wc_product_meta_lookup parent_wc_product_meta_lookup ON {$wpdb->posts}.post_type = 'product_variation' AND parent_wc_product_meta_lookup.product_id = {$wpdb->posts}.post_parent";
    return $join;
}

// 定制WooCommerce后台产品搜索的筛选条件（仅保留标题和SKU检索）
add_filter('woocommerce_product_admin_search_where', 'custom_product_search_where', 10, 2);
function custom_product_search_where($where, $term) {
    global $wpdb;
    $like_term = '%' . $wpdb->esc_like($term) . '%';
    
    // 仅保留标题、产品SKU、变体父产品SKU的搜索规则
    $where = "
        AND (
            {$wpdb->posts}.post_title LIKE '{$like_term}'
            OR wc_product_meta_lookup.sku LIKE '{$like_term}'
            OR (
                {$wpdb->posts}.post_type = 'product_variation'
                AND wc_product_meta_lookup.sku = ''
                AND parent_wc_product_meta_lookup.sku LIKE '{$like_term}'
            )
        )
    ";
    return $where;
}

// 禁用WordPress默认的冗余搜索字段
add_action('pre_get_posts', 'custom_disable_extra_search_fields');
function custom_disable_extra_search_fields($query) {
    global $pagenow;
    // 仅针对后台产品编辑页面的搜索请求生效
    if (is_admin() && $pagenow === 'edit.php' && $query->get('post_type') === 'product' && $query->is_search()) {
        // 强制只搜索标题字段，避免默认的内容、摘要检索
        $query->set('search_columns', array('post_title'));
    }
    return $query;
}

额外优化建议 #

1. 添加数据库索引提速：
   给标题和SKU字段添加索引，可进一步缩小数据扫描范围：

   CREATE INDEX idx_post_title ON wp_posts(post_title);
   CREATE INDEX idx_wc_sku ON wp_wc_product_meta_lookup(sku);
   

   注意替换语句中的wp_为你的数据库前缀。

2. 解决admin-ajax超时问题：
   查询优化后，后台搜索速度提升会直接缓解admin-ajax.php超时。如果仍有问题，可在Nginx配置中延长超时时间：

   location ~ ^/wp-admin/admin-ajax.php$ {
       proxy_read_timeout 300s;
       proxy_connect_timeout 300s;
   }
   

3. 优化搜索习惯：
   尽量使用关键词开头的搜索（如DELETEME而非%DELETEME），这类查询能更好利用索引，进一步降低检索耗时。

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