用户搜索功能问题排查：仅姓氏搜索有效，全名搜索无结果

看起来你遇到的问题大概率是数据库查询语句的匹配逻辑出了问题——毕竟搜姓氏能返回结果、全名不行，说明数据库连接和基础查询流程是通的，只是匹配范围或者方式不对。结合你提到的代码片段，我帮你梳理几个最可能的原因和解决办法：

1. 查询用了精确匹配而非模糊匹配 #

如果你的SQL语句是类似WHERE last_name = %s这种精确等于的写法，那搜全名（比如"张三"而不是"张"）自然找不到匹配项。你需要改成模糊匹配，用LIKE关键词，并且给查询关键词加上通配符%（表示任意字符）。

举个WordPress WPDB的正确写法：

if (isset($_POST['user'])) {
    $keyword = $_POST['user'];
    // 先转义关键词避免SQL注入和特殊字符冲突
    $escaped_keyword = $wpdb->esc_like($keyword);
    // 用LIKE模糊匹配，同时覆盖名字和姓氏字段
    $skuser = $wpdb->prepare(
        "SELECT * FROM your_users_table WHERE first_name LIKE %s OR last_name LIKE %s",
        '%' . $escaped_keyword . '%',
        '%' . $escaped_keyword . '%'
    );
    $results = $wpdb->get_results($skuser);
    var_dump($results);
}

2. 只匹配了姓氏字段，没覆盖名字字段 #

很多时候新手会只在姓氏字段里做查询，但全名包含了名字和姓氏两部分，所以得同时匹配first_name和last_name两个字段（如果你的表是分开存这两个字段的），或者匹配一个预先合并的full_name字段（如果表中有这个字段的话）。

如果想直接匹配合并后的全名，可以用CONCAT函数：

$skuser = $wpdb->prepare(
    "SELECT * FROM your_users_table WHERE CONCAT(first_name, ' ', last_name) LIKE %s",
    '%' . $wpdb->esc_like($keyword) . '%'
);

3. 关键词空格未处理 #

如果用户输入的全名是带空格的（比如"John Doe"），而你的查询逻辑没考虑这种情况——比如只把整个字符串拿去匹配单个字段——那也会找不到结果。上面的CONCAT写法就能解决这个问题，或者你也可以把关键词按空格拆分，分别匹配名字和姓氏。

快速排查技巧 #

你可以在执行查询前，把生成的SQL语句打印出来看看：

echo $skuser;

对比搜姓氏和搜全名时的SQL语句差异，就能直观定位到哪里出问题了。

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