Android 11下使用Java无法从相册选择图片的问题排查

问题核心：Android 11+ 分区存储限制 #

你的旧ImageUtils库失效，大概率是因为用了直接读取文件路径的逻辑——Android 11开始强制启用分区存储，传统的外部存储路径访问方式被限制，无法直接获取文件。

兼容Android 11及以下的解决步骤 #

1. 相册图片改用MediaStore查询，避免直接访问文件路径 #

Android 10及以上必须通过MediaStore API访问公共相册，不能再使用Environment.getExternalStoragePublicDirectory()这类方法。示例逻辑：

// 查询相册内的图片
String[] projection = {MediaStore.Images.Media._ID, MediaStore.Images.Media.DISPLAY_NAME};
Cursor cursor = getContentResolver().query(
    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
    projection,
    null,
    null,
    MediaStore.Images.Media.DATE_ADDED + " DESC"
);

if (cursor != null) {
    while (cursor.moveToNext()) {
        long imageId = cursor.getLong(cursor.getColumnIndexOrThrow(MediaStore.Images.Media._ID));
        Uri imageUri = ContentUris.withAppendedId(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, imageId);
        // 通过Uri获取图片输入流，用于后续处理（如转Bitmap）
        InputStream inputStream = getContentResolver().openInputStream(imageUri);
        Bitmap bitmap = BitmapFactory.decodeStream(inputStream);
        // 你的业务逻辑...
    }
    cursor.close();
}

2. 权限适配不同Android版本 #

• Android 10及以下：必须动态申请READ_EXTERNAL_STORAGE权限，获取授权后再执行图片操作
• Android 11及以上：同样需要申请READ_EXTERNAL_STORAGE，但仅能通过MediaStore或存储访问框架（SAF）访问文件，无法直接读取其他应用的私有目录

3. 相机拍照用FileProvider规避权限问题 #

相机拍照后直接存储到外部存储会触发权限限制，建议用FileProvider生成安全Uri：

1. 在AndroidManifest.xml中注册FileProvider：

<provider
    android:name="androidx.core.content.FileProvider"
    android:authorities="${applicationId}.fileprovider"
    android:exported="false"
    android:grantUriPermissions="true">
    <meta-data
        android:name="android.support.FILE_PROVIDER_PATHS"
        android:resource="@xml/file_paths" />
</provider>

2. 新建res/xml/file_paths.xml配置文件路径：

<paths xmlns:android="http://schemas.android.com/apk/res/android">
    <external-files-path name="camera_photos" path="Pictures" />
</paths>

3. 拍照时生成文件与Uri：

File photoFile = new File(getExternalFilesDir(Environment.DIRECTORY_PICTURES), "temp_photo.jpg");
Uri photoUri = FileProvider.getUriForFile(this, getPackageName() + ".fileprovider", photoFile);

Intent takePictureIntent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE);
takePictureIntent.putExtra(MediaStore.EXTRA_OUTPUT, photoUri);
startActivityForResult(takePictureIntent, REQ_CODE_CAMERA);

4. 用ActivityResultContracts替代旧的onActivityResult #

AndroidX推荐使用该新API，比传统onActivityResult更简洁且兼容高版本：

// 注册相册选择回调
ActivityResultLauncher<String[]> pickImageLauncher = registerForActivityResult(
    new ActivityResultContracts.OpenDocument(),
    uri -> {
        if (uri == null) return;
        // 持久化Uri权限，避免后续无法访问
        getContentResolver().takePersistableUriPermission(uri,
            Intent.FLAG_GRANT_READ_URI_PERMISSION);
        // 处理选中的图片Uri
        InputStream inputStream = getContentResolver().openInputStream(uri);
        // 你的业务逻辑...
    }
);

// 启动相册选择
pickImageLauncher.launch(new String[]{"image/*"});

自查现有代码的关键点 #

• 是否仍在直接使用外部存储根路径（如/sdcard/Pictures）？Android 11+已禁止此类访问
• Android 11+环境下是否正确通过MediaStore查询图片？
• 是否完成了动态权限申请，且在权限授权后才执行图片获取逻辑？
• 如果使用SAF选择图片，是否持久化了Uri访问权限？

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