Android部分机型调用相册选图后Fragment无法接收返回结果

问题表现 #

• 模拟器、小米Redmi Note 8 Pro等机型运行正常：相册可正常拉起，用户选图后能成功接收到返回的图片数据
• OnePlus 8、部分三星设备存在异常：相册可正常拉起，用户完成选图操作后，Fragment无法正确获取到选中的图片结果

原有问题代码 #

权限校验与相册拉起逻辑 #

if (ContextCompat.checkSelfPermission(
        requireContext(),
        Manifest.permission.READ_EXTERNAL_STORAGE
    ) != PackageManager.PERMISSION_GRANTED &&
    ContextCompat.checkSelfPermission(
        requireContext(),
        Manifest.permission.WRITE_EXTERNAL_STORAGE
    ) != PackageManager.PERMISSION_GRANTED
) {
    requestStoragePermissionLauncher.launch(Manifest.permission.READ_EXTERNAL_STORAGE)
} else {
    val intent =
        Intent(Intent.ACTION_PICK, MediaStore.Images.Media.INTERNAL_CONTENT_URI)
    intent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true)
    resultLauncher.launch(intent)
}

返回结果处理逻辑 #

private var resultLauncher =
    registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result ->
        if (result.resultCode == Activity.RESULT_OK) {
            if (result.data?.clipData != null) {
                val count: Int = result.data!!.clipData
                    ?.itemCount
                    ?: 0
                for (i in 0 until count) {
                    //Processing data here 
                }
            }
        }
    }

问题根因 #

1. 权限适配不全：原有逻辑同时校验读写存储权限，没有适配Android 13及以上版本的细分媒体权限规则，部分高版本系统上会出现权限判定异常。
2. Intent配置缺失：没有显式指定选择的文件类型，部分三星、OnePlus的定制系统相册对不带type参数的ACTION_PICK意图返回逻辑做了修改，单选图片时不会返回clipData字段。
3. 结果处理逻辑有漏洞：只处理了clipData承载的多图返回场景，完全漏掉了单图通过data.getData()返回的分支，导致单选时拿不到任何数据，看起来像是没有收到回调。
4. 注册时机隐患：如果resultLauncher在Fragment生命周期的onViewCreated及之后才注册，部分系统会把结果回调给宿主Activity，不会路由到当前Fragment。

修复方案 #

1. 修正权限适配逻辑 #

根据系统版本匹配对应的读取图片权限，不需要强制校验写存储权限：

• Android 12（API 32）及以下：使用READ_EXTERNAL_STORAGE权限
• Android 13（API 33）及以上：使用READ_MEDIA_IMAGES权限

2. 补全Intent兼容性配置 #

显式指定选择类型为图片，添加临时读权限标记，保证不同厂商系统都能正确处理选图请求。

3. 完善结果处理分支 #

同时兼容多图、单图两种返回格式，统一收集选中的图片Uri后再做业务处理。

修复后完整代码 #

权限校验与相册拉起

// 根据系统版本获取需要申请的图片读取权限
val readImagePermission = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    Manifest.permission.READ_MEDIA_IMAGES
} else {
    Manifest.permission.READ_EXTERNAL_STORAGE
}
if (ContextCompat.checkSelfPermission(requireContext(), readImagePermission) != PackageManager.PERMISSION_GRANTED) {
    requestStoragePermissionLauncher.launch(readImagePermission)
} else {
    val pickIntent = Intent(Intent.ACTION_PICK, MediaStore.Images.Media.INTERNAL_CONTENT_URI).apply {
        type = "image/*"
        putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true)
        addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
    }
    resultLauncher.launch(pickIntent)
}

返回结果处理

private var resultLauncher =
    registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result ->
        if (result.resultCode == Activity.RESULT_OK) {
            val resultData = result.data
            val selectedImageUris = mutableListOf<Uri>()
            // 处理多图选择返回
            if (resultData?.clipData != null) {
                val itemCount = resultData.clipData?.itemCount ?: 0
                for (i in 0 until itemCount) {
                    resultData.clipData?.getItemAt(i)?.uri?.let {
                        selectedImageUris.add(it)
                    }
                }
            }
            // 处理单图选择返回（适配三星、OnePlus等定制系统的返回逻辑）
            else if (resultData?.data != null) {
                resultData.data?.let {
                    selectedImageUris.add(it)
                }
            }

            // 统一处理选中的图片
            if (selectedImageUris.isNotEmpty()) {
                // 在这里写你的图片处理逻辑
            }
        }
    }

注意：resultLauncher的注册必须放在Fragment的onCreate/onAttach生命周期阶段执行，不要延后到onViewCreated里注册，避免回调路由异常。

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