如何在 Android 11（API 30）及更高版本中正确选取图库图片-java教程-PHP中文网

本文详解如何在 Android 11+（R 及以上）和 Android 10（Q）及以下设备上统一、兼容地从图库选择图片，重点解决因 maxSdkVersion="29" 导致高版本权限失效、ACTION_PICK 无法正常工作的问题，并提供适配方案与最佳实践。

本文详解如何在 android 11+（r 及以上）和 android 10（q）及以下设备上统一、兼容地从图库选择图片，重点解决因 `maxsdkversion="29"` 导致高版本权限失效、`action_pick` 无法正常工作的问题，并提供适配方案与最佳实践。

在 Android 11（API 30）及更高版本中，Google 进一步收紧了对外部存储的访问限制。自 Android 10（Q）引入分区存储（Scoped Storage）起，READ_EXTERNAL_STORAGE 权限已不再默认授予对所有媒体文件的读取能力；而到了 Android 11，该权限即使被声明并授予，对 MediaStore 的访问也不再需要运行时申请此权限——系统会自动允许应用通过标准媒体 API（如 MediaStore.Images.Media.EXTERNAL_CONTENT_URI）安全访问用户图片、视频和音频。

因此，你遇到的问题根源在于：
✅ 在 AndroidManifest.xml 中错误地添加了 android:maxSdkVersion="29"
❌ 导致 Android 11+ 设备完全忽略该权限声明，进而使 ContextCompat.checkSelfPermission() 始终返回 PERMISSION_DENIED，selectImage() 永远无法执行。

✅ 正确做法：移除 maxSdkVersion，并适配权限逻辑

首先，立即删除 maxSdkVersion 属性：

<!-- ❌ 错误写法（仅适用于 API ≤29） -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxsdkversion="29"></uses-permission><!-- ✅ 正确写法（全版本兼容） --><uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission>

⚠️ 注意：从 Android 11 开始，READ_EXTERNAL_STORAGE 对媒体访问已“降级”为 install-time permission（安装即授予权限），无需运行时请求。但为兼容 Android 10 及以下设备，仍需保留该声明，并在代码中按需申请。

✅ 优化权限检查逻辑（兼容 API ≤29 和 ≥30）

不应在所有 Android 版本中都强制请求 READ_EXTERNAL_STORAGE。应按 SDK 版本动态判断：

private void requestImageSelection() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        // Android 11+：无需运行时权限，直接打开图库
        selectImage();
    } else {
        // Android 10 及以下：需检查并请求 READ_EXTERNAL_STORAGE
        if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE)
                != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(
                    this,
                    new String[]{Manifest.permission.READ_EXTERNAL_STORAGE},
                    REQUEST_CODE_STORAGE_PERMISSION
            );
        } else {
            selectImage();
        }
    }
}

同时更新 onRequestPermissionsResult，确保只处理旧版本的授权回调：

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_CODE_STORAGE_PERMISSION) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            selectImage();
        } else {
            Toast.makeText(this, R.string.permissao_recusada, Toast.LENGTH_SHORT).show();
        }
    }
}

✅ 推荐：使用 ActivityResultLauncher（现代 AndroidX 写法）

为提升可维护性与生命周期安全性，建议弃用 startActivityForResult()（已废弃），改用 registerForActivityResult：

private final ActivityResultLauncher<intent> imagePickerLauncher = registerForActivityResult(
        new ActivityResultContracts.StartActivityForResult(),
        result -> {
            if (result.getResultCode() == RESULT_OK && result.getData() != null) {
                Uri imageUri = result.getData().getData();
                // ✅ 安全获取图片（支持 Android 11+ Scoped Storage）
                handleSelectedImage(imageUri);
            }
        }
);

private void selectImage() {
    Intent intent = new Intent(Intent.ACTION_PICK, MediaStore.Images.Media.EXTERNAL_CONTENT_URI);
    intent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*");
    imagePickerLauncher.launch(intent);
}</intent>

? 补充说明：ACTION_PICK 在 Android 11+ 依然完全可用，且无需任何额外权限——它本质上是通过系统图库（如 Google Photos）代理选择，返回的是 content:// URI，天然符合分区存储规范。

✅ 最佳实践总结

✅ Manifest 中禁止使用 maxSdkVersion：它会切断高版本权限链，是兼容性最大隐患；
✅ 按 Build.VERSION.SDK_INT 分流权限逻辑：Android 11+ 跳过运行时权限检查；
✅ 始终使用 content:// URI（而非 file://）：确保路径安全、跨应用兼容；
✅ 优先采用 ActivityResultLauncher：避免 onActivityResult 生命周期风险；
✅ 无需 MANAGE_EXTERNAL_STORAGE：该权限仅用于文件管理器类应用，普通图片选取场景严禁申请（会被 Google Play 拒绝）。

遵循上述方案，你的应用即可在 Android 6.0（API 23）至 Android 14（API 34）全版本范围内稳定、合规地从图库选取图片。