Android API 33下部分图片无法获取真实路径的排查求助

核心原因 #

• 分区存储权限限制：Android 10（API29）起引入的Scoped Storage在API33上进一步收紧了权限。你的应用仅能完全访问自身创建的媒体文件（比如应用内拍摄的图片），对于其他应用（系统相机、第三方相册等）创建的图片，无法直接获取并访问其真实文件路径，只能通过ContentResolver进行操作。
• 厂商定制化MediaStore差异：三星Galaxy S20的MediaStore实现对非应用创建的媒体文件做了特殊处理，即便DocumentsContract.getDocumentId()返回了合法格式的_id，你的应用也没有权限查询到对应的真实路径，导致getDataColumn返回null。
• 旧路径方案失效：你使用的基于拆分docId获取路径的方法是Scoped Storage之前的兼容方案，在API30+的现代Android系统上已经不再可靠，尤其是厂商定制设备。

最优解决方案：跳过真实路径，直接通过Uri上传 #

Android官方推荐的文件上传方式是直接通过ContentResolver获取文件输入流，无需依赖真实路径，完美适配所有API版本和厂商设备。

代码示例

fun uploadImage(context: Context, imageUri: Uri) {
    // 通过ContentResolver获取文件输入流，use语法自动关闭流
    context.contentResolver.openInputStream(imageUri)?.use { inputStream ->
        // 替换为你的服务器上传逻辑，示例：转换为Retrofit可用的RequestBody
        val requestBody = RequestBody.create(
            MediaType.parse("image/jpeg"),
            inputStream.readBytes()
        )
        // 调用上传API：apiService.uploadImage(requestBody)
    } ?: run {
        // 处理输入流获取失败的异常情况
    }
}

权限适配说明

• API33及以上：需申请READ_MEDIA_IMAGES权限
• API23至API29：需申请READ_EXTERNAL_STORAGE权限

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