WordPress中get_posts()的search_columns参数为何不生效？

你的操作本身没有错误，但在WordPress 5.9.2版本中，search_columns参数与s搜索参数配合时，存在参数逻辑被默认搜索钩子覆盖的情况，导致仅搜索标题的设置失效。以下是两种可行的解决方法：

方法一：改用WP_Query直接查询（更可靠） #

get_posts会默认启用部分简化参数，可能干扰search_columns的生效逻辑，直接使用WP_Query实例可以规避这个问题：

function search_posts($keyword, $params) {
    $query_args = array(
        'post_type'      => $params['type'],
        'post_status'    => array('publish', 'draft', 'pending', 'future'),
        'posts_per_page' => 10, // 推荐使用WP_Query标准参数替代numberposts
        'search_columns' => array('post_title'),
        's'              => $keyword,
        'no_found_rows'  => true, // 匹配get_posts默认行为，提升查询性能
    );

    $query = new WP_Query($query_args);
    $matching_posts = $query->posts;

    // 重置查询状态，避免影响后续操作
    wp_reset_postdata();

    return $matching_posts;
}

方法二：手动过滤搜索SQL（针对参数失效场景） #

如果方法一仍无效，可以通过posts_where钩子强制修改SQL语句，移除内容搜索的逻辑：

function search_posts($keyword, $params) {
    // 添加临时钩子，仅对当前查询生效
    $filter_id = add_filter('posts_where', function($where_clause, $wp_query) use ($keyword) {
        global $wpdb;
        // 验证当前查询是否为目标搜索请求
        if ($wp_query->get('s') === $keyword && $wp_query->get('search_columns') === array('post_title')) {
            // 移除SQL中搜索文章内容的片段
            $where_clause = preg_replace(
                "/OR \({$wpdb->posts}\.post_content LIKE '%.+%'\)/i",
                '',
                $where_clause
            );
        }
        return $where_clause;
    }, 10, 2);

    $args = array(
        'post_type'      => $params['type'],
        'post_status'    => array('publish', 'draft', 'pending', 'future'),
        'numberposts'    => 10,
        'search_columns' => array('post_title'),
        's'              => $keyword,
    );

    $matching_posts = get_posts($args);

    // 移除临时钩子，防止影响其他查询
    remove_filter('posts_where', $filter_id);

    return $matching_posts;
}

额外注意事项 #

• 确保没有其他插件或主题通过pre_get_posts、posts_where等钩子修改搜索逻辑，原生WordPress环境下无需担心此问题。
• 优先使用posts_per_page替代numberposts，它是WP_Query的标准参数，兼容性更强。

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