Android联系人高分辨率显示照片同步后无法读取的技术问询

我之前碰到过完全一样的问题，核心原因是你依赖了Contacts聚合表（ContactsContract.Contacts）的photo_uri/file_id字段，但同步服务完成后，系统会更新这个聚合视图的字段指向缩略图——但实际上高清照片一直保存在对应的RawContacts条目里，Google Contacts就是绕开了聚合表，直接从RawContacts获取高清资源的。下面是兼容API21+、对齐Google Contacts逻辑的解决方案：

一、读取高清照片的核心逻辑：直接从RawContacts获取 #

Contacts表是系统对多个RawContacts（比如同一联系人的Google账户、本地账户条目）的聚合视图，同步后系统可能会将聚合表的照片字段替换为统一的缩略图，但RawContacts里的原始高清照片不会丢失。Google Contacts的读取逻辑是：

• 跳过Contacts表的photo_uri，直接遍历目标联系人关联的所有RawContacts
• 找到带有高清照片的RawContact，读取其DisplayPhoto资源
• 若所有RawContacts都无高清照，再 fallback 到聚合表的缩略图

具体实现步骤 #

1. 获取目标联系人关联的所有RawContacts ID
   通过contact_id查询RawContacts表，筛选出属于该联系人的所有RawContact条目：

   String[] projection = {RawContacts._ID};
   String selection = RawContacts.CONTACT_ID + " = ?";
   String[] selectionArgs = {String.valueOf(targetContactId)};
   Cursor cursor = getContentResolver().query(RawContacts.CONTENT_URI, projection, selection, selectionArgs, null);
   

2. 遍历RawContacts，读取高清照片
   对每个RawContact ID，构造DisplayPhoto的Uri，尝试打开输入流：

   if (cursor != null && cursor.moveToFirst()) {
       do {
           long rawContactId = cursor.getLong(cursor.getColumnIndex(RawContacts._ID));
           // 检查该RawContact是否有照片
           int hasPhoto = cursor.getInt(cursor.getColumnIndex(RawContacts.HAS_PHOTO));
           if (hasPhoto == 1) {
               Uri photoUri = ContentUris.withAppendedId(RawContacts.DisplayPhoto.CONTENT_URI, rawContactId);
               InputStream inputStream = getContentResolver().openInputStream(photoUri);
               if (inputStream != null) {
                   // 这里拿到的就是高清照片流，直接使用即可
                   Bitmap highResPhoto = BitmapFactory.decodeStream(inputStream);
                   inputStream.close();
                   break; // 找到第一个带高清照的RawContact就停止
               }
           }
       } while (cursor.moveToNext());
       cursor.close();
   }
   

3. Fallback到缩略图（可选）
   如果遍历完所有RawContacts都没找到高清照，再使用Contacts表的photo_uri加载缩略图：

   String[] contactProjection = {Contacts.PHOTO_URI};
   Cursor contactCursor = getContentResolver().query(Contacts.CONTENT_URI, contactProjection, Contacts._ID + " = ?", new String[]{String.valueOf(targetContactId)}, null);
   if (contactCursor != null && contactCursor.moveToFirst()) {
       String thumbUriStr = contactCursor.getString(contactCursor.getColumnIndex(Contacts.PHOTO_URI));
       if (thumbUriStr != null) {
           Uri thumbUri = Uri.parse(thumbUriStr);
           // 加载缩略图逻辑
       }
       contactCursor.close();
   }
   

二、保存高清照片的验证（确保写入正确） #

虽然你提到保存没问题，但还是要确认保存操作是针对RawContacts而非Contacts表：

• 不要直接操作Contacts表的照片字段，因为聚合表的修改不会同步到RawContacts，同步后会被覆盖
• 正确的保存方式是针对目标RawContact的DisplayPhoto Uri写入数据：

  // 假设你已经拿到要写入的rawContactId
  Uri photoUri = ContentUris.withAppendedId(RawContacts.DisplayPhoto.CONTENT_URI, rawContactId);
  OutputStream outputStream = getContentResolver().openOutputStream(photoUri);
  if (outputStream != null) {
      // 将高清图片数据写入outputStream，比如从Bitmap转换
      highResBitmap.compress(Bitmap.CompressFormat.JPEG, 100, outputStream);
      outputStream.close();
      // 更新RawContacts的HAS_PHOTO字段为1
      ContentValues values = new ContentValues();
      values.put(RawContacts.HAS_PHOTO, 1);
      getContentResolver().update(RawContacts.CONTENT_URI, values, RawContacts._ID + " = ?", new String[]{String.valueOf(rawContactId)});
  }
  

三、兼容性说明（API21+） #

• ContactsContract.RawContacts.DisplayPhoto从API14开始就可用，完全兼容API21及以上版本
• 权限处理：读取需要READ_CONTACTS，保存需要WRITE_CONTACTS，API23+记得动态申请权限

四、同步后的状态处理 #

当同步完成后Contacts表的字段异常时，不需要等待系统触发聚合更新（像Google Contacts打开详情那样），直接按照上面的逻辑从RawContacts读取即可——这就是Google Contacts能正常加载高清照的核心原因：它不依赖聚合表的缓存字段，直接读取原始数据源。

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