升级至SDK 33后部分Android用户无法解码图片问题求助

背景与现象 #

我开发了一款照片读取与增强类App，近期因谷歌要求升级至SDK 33。发布后收到4位用户反馈：

• 无法读取旧照片，报错信息为Unable to decode file
• 相机拍照并在App内使用、保存功能正常
• 涉及机型：Pixel 6/7、Samsung S21 Ultra

测试情况 #

我在自己的Pixel 5a、多款旧三星机型，以及Android Studio Chipmunk的虚拟设备上测试，均运行正常。

疑问 #

1. 该问题的可能原因是什么？
2. 有哪些排查建议？
3. 升级至最新版Android Studio是否会有影响？

另外注意到谷歌2024年8月31日生效的照片和视频权限政策：限制申请READ_MEDIA_IMAGES、READ_MEDIA_VIDEO这类宽泛权限的App数量，仅允许App出于功能直接相关目的访问媒体文件，偶尔访问的App应使用系统选择器（如Android照片选择器）。

相关代码 #

options.inJustDecodeBounds = false;

try {
    bmp = BitmapFactory.decodeFile(photoFilePath, options);
} catch (Throwable t){
    bmp = null;
    showError("Out of memory error.  Reduce MPixel limit in settings.");
}

if (bmp == null) {
    showError("Unable to decode file." + photoFilePath);
    photoFilePath = null;
    return;
}

//this is how photoFilePath gets set
private void onSelectFromGalleryResult(Intent data) {
    try {
        // When an Image is picked
        if (data != null && data.getData() != null) {
            // Get the Image from data

            Uri selectedImage = data.getData();

            String[] filePathColumn = {MediaStore.Images.Media.DATA};
            // Get the cursor
            Cursor cursor = getContentResolver().query(selectedImage,
                    filePathColumn, null, null, null);
            // Move to first row
            cursor.moveToFirst();
            int columnIndex = cursor.getColumnIndex(filePathColumn[0]);
            photoFilePath = cursor.getString(columnIndex);
            cursor.close();

//                    showDiag("Image string " + photoFilePath);

//                    bmp = MediaStore.Images.Media.getBitmap(getContentResolver(), selectedImage);
        } else {
            showDiag("You haven't picked an image");
        }
    } catch (Exception e) {
        showError("Something went wrong");
        e.printStackTrace();

    }
}

一、核心原因分析 #

1. MediaStore.Images.Media.DATA字段失效：Android 10（API 29）起引入Scoped Storage，该字段返回的文件路径在Android 13+（SDK33）新机型上可能无效或无法直接访问，尤其是旧照片的存储路径被系统保护，直接读取会失败。
2. 权限适配问题：SDK33下READ_MEDIA_IMAGES权限的生效逻辑更严格，即使获取权限，直接访问文件路径仍可能被系统限制；而相机拍照生成的文件存储在App可控区域，不受此限制。
3. 机型存储实现差异：Pixel 6/7、Samsung S21 Ultra这类新机型对Scoped Storage执行更彻底，旧机型或虚拟设备存在兼容性放宽的情况。

二、排查建议 #

1. 补充日志：在报错逻辑中添加photoFilePath的具体值日志，确认路径是否为空或无效；同时捕获BitmapFactory.decodeFile的所有异常（如FileNotFoundException），而非仅OOM。
2. 真机复现：使用云测试平台或真机测试Pixel 6/7、Samsung S21 Ultra，复现问题场景。
3. 权限验证：检查App是否正确动态申请READ_MEDIA_IMAGES权限，且用户已授予；确认SDK33下权限申请流程合规。
4. 路径有效性检查：在代码中添加File.exists()和File.canRead()判断，验证photoFilePath对应的文件状态。

三、修复方案 #

1. 改用ContentResolver读取：放弃通过MediaStore.Images.Media.DATA获取路径，直接用Content URI读取图片流：

// 替换原decodeFile逻辑
try (InputStream is = getContentResolver().openInputStream(selectedImage)) {
    bmp = BitmapFactory.decodeStream(is, null, options);
} catch (IOException e) {
    showError("Failed to read image file");
    e.printStackTrace();
}

2. 适配Scoped Storage：若App核心功能是处理照片，确保权限申请符合谷歌政策；若仅偶尔访问，改用Android照片选择器（Intent.ACTION_PICK或官方照片选择器API），无需申请宽泛权限。
3. 废弃MediaStore.Images.Media.DATA：该字段在Android 10+已标记为废弃，不再可靠，必须改用Content URI方式访问媒体文件。

四、Android Studio升级影响 #

升级至最新版Android Studio不会直接引发问题，但新版会更严格地检查Scoped Storage相关代码，帮助提前发现兼容性问题。建议升级，同时使用最新SDK工具和构建工具，确保适配逻辑符合官方规范。

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