Android 30中ContentResolver结构化查询参数GROUP_BY失效如何解决

Android 30新增的Bundle式结构化查询参数，只是框架层定义的一套通用参数约定，参数能不能生效，完全取决于你查询的ContentProvider有没有做对应解析逻辑，不是传了就一定能执行。
你查的是联系人模块的ContactsContract.Data表，这个Provider只适配了QUERY_ARG_SQL_SELECTION、QUERY_ARG_SQL_SORT_ORDER这类和旧版query接口参数一一对应的逻辑，根本没写QUERY_ARG_SQL_GROUP_BY的解析和SQL拼接代码，你传进去的值直接被丢弃了，和你写的参数格式、值对不对没有关系。这也是为什么筛选、排序都正常，唯独分组没效果。

你要按CONTACT_ID去重、每个联系人只留一条记录，三个方案按推荐度排序：

• 直接查联系人主表
  把查询URI换成ContactsContract.Contacts.CONTENT_URI，这张表本来就是以CONTACT_ID为主键，一个联系人对应唯一一行，你要的DISPLAY_NAME字段直接存在这张表里，手机号、邮箱这类多值数据后续可以通过CONTACT_ID关联查Data表，从根源上避免重复行，完全不需要额外写去重逻辑。
• 用框架原生去重参数替代GROUP_BY
  如果必须从Data表查询，可以试试传DISTINCT标记，这个参数联系人Provider是适配了的：

  val bundle = Bundle().apply {
      putString(ContentResolver.QUERY_ARG_SQL_SELECTION, selectQuery)
      putString(ContentResolver.QUERY_ARG_SQL_SORT_ORDER, sortOrder)
      // 开启结果去重
      putInt(ContentResolver.QUERY_ARG_DISTINCT, 1)
  }
  

  要注意这个方案的限制：DISTINCT是对返回的整行字段做组合去重，如果你把MIMETYPE、DATA1这种同一个联系人会有多个不同值的字段放在查询投影里，去重是不会生效的——毕竟同一个CONTACT_ID下，手机号行和邮箱行的MIMETYPE、DATA1值完全不同，会被判定为两条不同记录。
• 业务层手动去重
  你现在写的for循环遍历、按CONTACT_ID筛除重复行的逻辑完全能用。普通用户的联系人量级基本在几千条以内，内存遍历的性能损耗几乎可以忽略，没必要硬凑SQL层的GROUP BY实现。

踩坑提醒：所有带QUERY_ARG_SQL_前缀的自定义SQL参数，系统内置Provider的支持度都参差不齐。比如媒体存储Provider从Android 10开始就支持GROUP_BY参数，但联系人Provider到Android 14版本都没加相关解析逻辑，用这类参数前一定要在目标版本上实测，不要想当然认为全系统通用。

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