WooCommerce仅搜索商品标题功能失效排查求助

嘿，我经手过不少老代码突然“罢工”的情况，咱们一步步拆解你的问题。你之前在functions.php里用了多年的仅搜索商品标题的代码突然失效报错，大概率和WordPress或WooCommerce的版本更新脱不了干系——毕竟这俩工具每次大版本迭代都会调整底层的搜索逻辑，老代码很容易跟不上节奏。结合你给出的代码片段，我梳理了几个最可能的原因：

1. 搜索钩子或查询逻辑的底层变更 #

你原来的代码用了posts_search钩子来修改搜索查询，但WordPress 5.x之后或者WooCommerce 3.x+的版本里，这个钩子的触发时机、参数传递方式都可能变了：

• WooCommerce现在为了优化产品搜索，新增了自己的搜索过滤逻辑（比如woocommerce_product_search_query这类钩子），优先级可能比你原来的函数更高，直接覆盖了你的修改；
• 原来直接访问$wp_query->query_vars['s']获取搜索词的方式，现在可能因为WP_Query的结构调整，取不到正确的值，导致搜索逻辑失效。

2. 函数命名或优先级冲突 #

你的函数名是__search_by_title_only，虽然加了双下划线，但如果后来安装的插件、主题更新里出现了同名函数，就会触发PHP的“cannot redeclare function”错误，直接导致代码失效。另外，如果你原来的代码没指定钩子的优先级，现在WooCommerce自带的搜索过滤优先级更高，也会把你的逻辑覆盖掉。

3. SQL查询的兼容性问题 #

老代码里用$wpdb拼接的SQL语句，可能在新版本的数据库（比如MySQL 8.0）或者WooCommerce的产品表结构变更后不兼容了：

• 比如产品表的前缀、字段名调整，导致你的SQL查询找不到对应的数据；
• 没有正确处理搜索词的转义，在新版本里触发SQL语法错误，或者被WordPress的安全机制拦截了。

4. 未限定搜索范围导致逻辑混乱 #

原来的代码可能没判断当前搜索是否是WooCommerce产品搜索，也没限定只作用于主查询，导致在后台搜索、其他自定义搜索场景下触发错误，进而影响前台的产品搜索功能。

适配新版本的修复示例代码 #

如果你的报错是因为上述问题，可以试试这段更新后的代码，记得备份好functions.php再替换：

// 仅搜索WooCommerce商品标题
add_filter('posts_search', 'wc_search_by_product_title_only', 20, 2);
function wc_search_by_product_title_only($search, $wp_query) {
    global $wpdb;

    // 跳过非搜索请求、非主查询、无搜索词的情况
    if (empty($search) || !$wp_query->is_search() || !$wp_query->is_main_query()) {
        return $search;
    }

    // 仅针对WooCommerce产品类型
    if ($wp_query->get('post_type') !== 'product') {
        return $search;
    }

    $search_term = $wp_query->get('s');
    if (empty($search_term)) {
        return $search;
    }

    // 安全处理搜索词，避免SQL注入
    $like_pattern = '%' . $wpdb->esc_like($search_term) . '%';
    $search = $wpdb->prepare(
        "AND ($wpdb->posts.post_title LIKE %s)",
        $like_pattern
    );

    return $search;
}

这段代码做了这些优化：

• 指定了更高的钩子优先级（20），确保能覆盖WooCommerce的默认逻辑；
• 严格限定只作用于前台主搜索、产品类型的请求；
• 用$wp_query->get()安全获取搜索词，避免直接访问query_vars的风险；
• 用$wpdb->esc_like()和prepare()处理搜索词，避免SQL注入和语法错误。

如果还是报错，建议你去PHP错误日志里找具体的错误信息（比如“Undefined variable”“SQL syntax error”），有了具体错误就能更精准定位问题啦。

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