Android ContactsContract.Data查询去重方案咨询（禁止游标后处理）

我遇到了一个Android多账户联系人聚合的问题：当设备添加多个账户后，相同的联系人电话/邮箱记录会因为跨账户聚合而在ContactsContract.Data的查询结果中重复出现。

当前我的查询代码支持自由格式搜索（匹配显示名、电话或邮箱的部分内容），运行效率很高，但无法处理重复记录。我明确要求不能进行游标后处理（比如遍历游标在内存中去重、同步到自有数据库等），希望直接修改查询语句，让结果仅包含唯一的电话或邮箱记录。

当前查询代码如下：

// (Mimetype == Phone OR Mimetype == Email) 
// AND 
// ( 
//   DisplayName LIKE searchQuery 
//   OR 
//   (Mimetype == Phone AND NormalizedPhone LIKE phoneNormalizedSearchQuery) 
//   OR 
//   (Mimetype == Email AND Email LIKE searchQuery) 
// ) 
String selection = "" + 
    "(" + ContactsContract.Data.MIMETYPE + "='" + ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE + "'" + 
    " OR " + ContactsContract.Data.MIMETYPE + "='" + ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE + "')" + 
    " AND " + 
    "(" + ContactsContract.Data.DISPLAY_NAME + " LIKE '%" + searchQuery + "%'" + 
    " OR " + 
    "(" + ContactsContract.Data.MIMETYPE + "='" + ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE + "'" + 
    " AND " + ContactsContract.CommonDataKinds.Phone.NORMALIZED_NUMBER + " LIKE '%" + phoneNormalizedSearchQuery + "%'" + 
    ")" + 
    " OR " + 
    "(" + ContactsContract.Data.MIMETYPE + "='" + ContactsContract.CommonDataKinds.Email.CONTENT_ITEM_TYPE + "'" + 
    " AND " + ContactsContract.CommonDataKinds.Email.ADDRESS + " LIKE '%" + searchQuery + "%'" + 
    ")" + 
    ")";

Uri uri = ContactsContract.Data.CONTENT_URI.buildUpon()
    .appendQueryParameter(ContactsContract.CommonDataKinds.Contactables.VISIBLE_CONTACTS_ONLY, "true")
    .build();

return new CursorLoader(context, uri, CONTACTS_PROJECTION, selection, null, 
    ContactsContract.Contacts.DISPLAY_NAME + " COLLATE LOCALIZED ASC");

嘿，这个问题我之前处理多账户联系人时碰到过，刚好可以用数据库层面的逻辑直接解决，完全不需要做游标后处理，还能保住原查询的高效性。

核心思路是利用SQL的GROUP BY子句，结合Android联系人数据库的CONTACT_ID（聚合后的唯一联系人ID）、联系方式类型（MIMETYPE）以及核心联系方式值来分组，确保每个唯一的「联系人-联系方式」组合只返回一条记录。同时，我们可以优先保留标记为「主要联系方式」的记录，让结果更合理。

具体修改步骤： #

1. 检查并更新投影字段：
   确保你的CONTACTS_PROJECTION包含以下关键字段，不然分组和筛选会失效：

   private static final String[] CONTACTS_PROJECTION = {
       ContactsContract.Data._ID,
       ContactsContract.Data.CONTACT_ID, // 聚合后的唯一联系人ID
       ContactsContract.Data.DISPLAY_NAME,
       ContactsContract.Data.MIMETYPE, // 区分电话/邮箱
       ContactsContract.CommonDataKinds.Phone.NORMALIZED_NUMBER, // 标准化电话（去重更准确）
       ContactsContract.CommonDataKinds.Email.ADDRESS, // 邮箱地址
       ContactsContract.Data.IS_PRIMARY // 标记是否为主要联系方式
   };
   

2. 修改查询的排序/分组逻辑：
   由于CursorLoader没有直接暴露GROUP BY参数，我们可以把分组逻辑拼接到sortOrder参数中（Android的SQLite实现支持这种写法），同时添加HAVING子句优先选择主要联系方式：

   String sortOrder = 
       // 先按显示名排序，保持原有排序逻辑
       ContactsContract.Contacts.DISPLAY_NAME + " COLLATE LOCALIZED ASC, " +
       // 按联系人ID、联系方式类型、核心值分组
       ContactsContract.Data.CONTACT_ID + ", " +
       ContactsContract.Data.MIMETYPE + ", " +
       // 动态选择分组核心字段：电话用标准化号码，邮箱用地址
       "CASE WHEN " + ContactsContract.Data.MIMETYPE + " = '" + ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE + "' " +
       "THEN " + ContactsContract.CommonDataKinds.Phone.NORMALIZED_NUMBER + 
       "ELSE " + ContactsContract.CommonDataKinds.Email.ADDRESS + " END " +
       // 分组规则
       "GROUP BY " + ContactsContract.Data.CONTACT_ID + ", " + ContactsContract.Data.MIMETYPE + ", " +
       "CASE WHEN " + ContactsContract.Data.MIMETYPE + " = '" + ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE + "' " +
       "THEN " + ContactsContract.CommonDataKinds.Phone.NORMALIZED_NUMBER + 
       "ELSE " + ContactsContract.CommonDataKinds.Email.ADDRESS + " END " +
       // 优先保留主要联系方式，无主要记录则保留唯一记录
       "HAVING MAX(" + ContactsContract.Data.IS_PRIMARY + ") = 1 OR COUNT(*) = 1";
   

3. 更新CursorLoader构造：
   把新的sortOrder传入CursorLoader，原有的selection和uri可以保持不变：

   Uri uri = ContactsContract.Data.CONTENT_URI.buildUpon()
       .appendQueryParameter(ContactsContract.CommonDataKinds.Contactables.VISIBLE_CONTACTS_ONLY, "true")
       .build();
   
   return new CursorLoader(context, uri, CONTACTS_PROJECTION, selection, null, sortOrder);
   

为什么这么做有效？ #

• 去重逻辑：通过GROUP BY按「联系人ID+类型+联系方式值」分组，直接在数据库层面过滤重复记录，不会返回多条相同的联系方式。
• 优先级保证：HAVING MAX(IS_PRIMARY) = 1确保如果同一个联系方式有多个来源（比如多个账户），优先返回标记为主要的那条；如果没有主要记录，就返回唯一的那条。
• 性能不变：所有逻辑都在数据库端执行，和原查询一样高效，几千条联系人依然能实时响应输入。

如果担心sortOrder拼接GROUP BY的兼容性，也可以直接使用ContentResolver.query()，它支持单独的groupBy参数：

String groupByClause = 
    ContactsContract.Data.CONTACT_ID + ", " + ContactsContract.Data.MIMETYPE + ", " +
    "CASE WHEN " + ContactsContract.Data.MIMETYPE + " = '" + ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE + "' " +
    "THEN " + ContactsContract.CommonDataKinds.Phone.NORMALIZED_NUMBER + 
    "ELSE " + ContactsContract.CommonDataKinds.Email.ADDRESS + " END";

String havingClause = "MAX(" + ContactsContract.Data.IS_PRIMARY + ") = 1 OR COUNT(*) = 1";

Cursor cursor = getContentResolver().query(
    uri,
    CONTACTS_PROJECTION,
    selection + " HAVING " + havingClause,
    null,
    ContactsContract.Contacts.DISPLAY_NAME + " COLLATE LOCALIZED ASC",
    groupByClause
);

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