WP_Query仅搜索文章标题时大小写不匹配致自动补全失效问题

问题描述 #

文章标题为「Test」，搜索小写的「test」时自动补全无结果，但搜索首字母大写的「Test」时正常显示，当前使用的WP_Query代码如下：

$results = new WP_Query(array(
    'post_type'      => array( 'dream'),
    'post_status'    => 'publish',
    'posts_per_page' => 221,
    's'              => stripslashes($_POST['search']),
));

$items = array();
while ( $results->have_posts() ) {
    $results->the_post();
    $items[] = get_the_title();
}

问题原因 #

这是因为WordPress的默认搜索行为依赖于数据库排序规则，如果你的wp_posts表使用了区分大小写的排序规则（比如utf8mb4_bin），就会出现大小写不匹配时搜不到结果的情况。

解决办法 #

方法1：用过滤器修改搜索的大小写敏感性

在主题的functions.php里添加以下代码，或在查询代码前临时添加过滤器，让搜索变为不区分大小写：

add_filter('posts_search', 'make_search_case_insensitive', 10, 2);
function make_search_case_insensitive($search, $wp_query) {
    global $wpdb;
    if (empty($search) || !$wp_query->get('s')) {
        return $search;
    }
    // 替换默认LIKE查询为不区分大小写版本
    $search_term = $wp_query->query_vars['s'];
    $search = str_replace(
        "{$wpdb->posts}.post_title LIKE '%{$search_term}%'",
        "{$wpdb->posts}.post_title LIKE '%{$search_term}%' COLLATE utf8mb4_general_ci",
        $search
    );
    return $search;
}

如果数据库用的是utf8编码，把utf8mb4_general_ci换成utf8_general_ci即可。

方法2：临时修改查询的WHERE条件

如果不想全局修改，可以在查询代码中临时添加过滤器，用完后移除，避免影响其他查询：

// 添加临时过滤器
add_filter('posts_where', 'custom_case_insensitive_search', 10, 2);
function custom_case_insensitive_search($where, $wp_query) {
    global $wpdb;
    $search_term = $wp_query->get('s');
    if ($search_term) {
        $escaped_term = esc_sql($wpdb->esc_like($search_term));
        // 添加不区分大小写的标题匹配
        $where .= " AND {$wpdb->posts}.post_title LIKE '%{$escaped_term}%' COLLATE utf8mb4_general_ci";
        // 移除默认搜索条件，避免重复匹配
        $where = preg_replace('/\(\s*' . preg_quote($wpdb->posts . '.post_title', '/') . '\s+LIKE\s*(\'[^\']+\')\s*\)/', '', $where);
    }
    return $where;
}

// 执行查询
$results = new WP_Query(array(
    'post_type'      => array( 'dream'),
    'post_status'    => 'publish',
    'posts_per_page' => 221,
    's'              => stripslashes($_POST['search']),
));

// 移除过滤器，不影响后续查询
remove_filter('posts_where', 'custom_case_insensitive_search');

$items = array();
while ( $results->have_posts() ) {
    $results->the_post();
    $items[] = get_the_title();
}

方法3：修改数据库表的排序规则（全局生效）

如果整个站点都需要不区分大小写的搜索，可以直接修改wp_posts表中post_title字段的排序规则：

1. 先备份数据库，然后登录phpMyAdmin或数据库管理工具
2. 找到wp_posts表，编辑post_title字段
3. 将排序规则改为utf8mb4_general_ci（对应utf8mb4编码）或utf8_general_ci（对应utf8编码）
4. 保存修改即可

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