WordPress自定义搜索查询如何排除hide_from_search_results为1的内容

云上老周

2026-10-5

解决方案

错误原因

表别名重复报错：你已经在cf_search_join中手动LEFT JOIN了一次wp_postmeta表，在pre_get_posts中配置meta_query时，WordPress内核会自动再次JOIN同一张表，没有自定义别名就会触发重复冲突。
SQL语法报错：MySQL的相等判断运算符是=而非==，同时你的过滤逻辑写反、缺少必要括号导致运算优先级错误，反而会把需要排除的内容纳入结果。

正确修改步骤

首先删除你之前在cf_posts_query函数中添加的meta_query配置代码，不需要通过内核的meta_query实现过滤。
直接修改cf_search_where函数，追加子查询过滤条件即可，不会和现有JOIN逻辑冲突：

function cf_search_where( $where ) {
    global $pagenow, $wpdb;

    if ( is_search() && !is_admin() ) {
        $where = preg_replace(
            "/\(\s*".$wpdb->posts.".post_title\s+LIKE\s*(\'[^\']+\')\s*\)/",
            "(".$wpdb->posts.".post_title LIKE $1) OR (".$wpdb->postmeta.".meta_value LIKE $1)", $where );
        
        $where .= ' AND ' . $wpdb->posts . '.post_mime_type != "image/jpeg"';
        // 新增排除hide_from_search_results为1的内容
        $where .= $wpdb->prepare(
            " AND NOT EXISTS (
                SELECT 1 FROM {$wpdb->postmeta} pm_hide
                WHERE pm_hide.post_id = {$wpdb->posts}.ID
                AND pm_hide.meta_key = %s
                AND pm_hide.meta_value = %d
            )",
            'hide_from_search_results',
            1
        );
    }

    return $where;
}
add_filter( 'posts_where', 'cf_search_where' );