Android：SQLite查询未返回全部联系人结果问题求助

我来帮你搞定这个联系人搜索漏结果的问题～先看你给出的代码片段，几个关键点可能导致了这个问题，咱们一步步来排查：

1. 最常见的问题：模糊匹配的通配符缺失 #

你当前的LIKE ?写法，如果selectionArgs里的搜索词没有加%前缀和后缀，只会匹配完全等于搜索词的联系人，而不是包含搜索词的结果。比如搜“李”，只会找到名字就是“李”的人，而“李白”“李四”都不会被命中。

修复方法：给搜索词前后加上%，同时注意不要提前转小写（COLLATE NOCASE已经会处理大小写不敏感了）：

String search = selectionArgs[0];
// 调整selection和参数，添加通配符
String selection = ContactsContract.Contacts.DISPLAY_NAME_PRIMARY + " LIKE ? COLLATE NOCASE";
Cursor c = mContext.getContentResolver().query(
    ContactsContract.Contacts.CONTENT_URI,
    new String[]{ContactsContract.Contacts._ID, ContactsContract.Contacts.DISPLAY_NAME_PRIMARY},
    selection,
    new String[]{"%" + search + "%"}, // 前后加%实现包含匹配
    null
);

2. 推荐使用系统原生的搜索URI #

Android的ContactsContract提供了专门的CONTENT_FILTER_URI，这个URI是系统优化过的搜索入口，不仅会匹配联系人的主名称，还会自动关联昵称、拼音（如果系统支持）、甚至关联的电话号码/邮箱，比自己写LIKE语句覆盖范围更广，准确性也更高。

替换成这种写法试试：

String search = selectionArgs[0];
// 构建搜索URI，自动处理编码
Uri searchUri = Uri.withAppendedPath(ContactsContract.Contacts.CONTENT_FILTER_URI, Uri.encode(search));
Cursor c = mContext.getContentResolver().query(
    searchUri,
    new String[]{ContactsContract.Contacts._ID, ContactsContract.Contacts.DISPLAY_NAME_PRIMARY},
    null, // 不需要自己写selection，系统会处理
    null,
    null
);

3. 处理SQL特殊字符的转义 #

如果搜索词里包含%或者_这类SQLite LIKE语句的特殊字符，会导致匹配逻辑异常（比如%会被当成通配符）。你可以添加一个转义函数来处理这些字符：

private String escapeSqlLike(String input) {
    // 转义%和_，避免干扰LIKE匹配
    return input.replace("%", "\\%").replace("_", "\\_");
}

// 使用时：
String escapedSearch = escapeSqlLike(selectionArgs[0]);
new String[]{"%" + escapedSearch + "%"}

4. 验证权限是否齐全 #

别忘了在AndroidManifest里声明READ_CONTACTS权限，并且在Android 6.0及以上版本动态申请权限。如果权限没有正确获取，查询可能会返回空或者部分受限结果。

按照上面的步骤调整后，应该就能拿到完整的匹配结果啦～

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