本文详解如何在 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 android:name="android.permission.READ_EXTERNAL_STORAGE" />⚠️ 注意：从 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);
}? 补充说明：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）全版本范围内稳定、合规地从图库选取图片。
