本文详解如何在 Android 11 及更高版本（Scoped Storage 强制启用）与 Android 10 及更低版本中，兼容性地从系统图库选取图片，无需读取外部存储权限，规避 READ_EXTERNAL_STORAGE 权限失效问题。
本文详解如何在 android 11 及更高版本（scoped storage 强制启用）与 android 10 及更低版本中，兼容性地从系统图库选取图片，无需读取外部存储权限，规避 `read_external_storage` 权限失效问题。
在 Android 11（API 级别 30）及以上，Google 彻底弃用 READ_EXTERNAL_STORAGE 对媒体文件的访问能力——即使你声明了该权限并成功获取，调用 ACTION_PICK 时仍可能因权限限制或目标 intent 不匹配而静默失败。你当前代码中使用 android:maxSdkVersion="29" 的写法，恰恰导致 Android 11+ 设备完全不申请该权限，进而使 selectImage() 在未授权状态下直接执行，最终 Intent.ACTION_PICK 因缺少必要上下文而无法启动图库（尤其在部分 OEM 定制系统中表现更明显）。
✅ 正确方案：放弃请求 READ_EXTERNAL_STORAGE，改用无需运行时权限的 Intent.ACTION_PICK + MediaStore URI 方案，并适配 Android 11+ 的作用域存储行为
✅ 推荐实现（全版本兼容）
1. 移除 maxSdkVersion 并精简权限声明（仅保留必要项）
<!-- AndroidManifest.xml --> <!-- 删除 maxSdkVersion，但注意：Android 11+ 不再需要此权限用于 PICK 操作 --> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /> <!-- 如果仅用于图库选取，甚至可完全移除此行（推荐） -->
⚠️ 注意：READ_EXTERNAL_STORAGE 在 Android 11+ 对 ACTION_PICK 非必需；保留它反而可能触发不必要的权限弹窗或被 Google Play 拒绝（若未在隐私政策中说明用途）。
2. 简化点击逻辑（无需动态权限检查）
layoutMiscellaneous.findViewById(R.id.layoutAddImage).setOnClickListener(view -> {
bottomSheetBehavior.setState(BottomSheetBehavior.STATE_COLLAPSED);
selectImage(); // 直接调用，无需先检查权限
});3. 安全、稳定的图片选取方法
private void selectImage() {
Intent intent = new Intent(Intent.ACTION_PICK);
intent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*");
// 关键：显式指定 Intent 类别，提升兼容性（尤其对 Android 12+ 和 Samsung/MIUI）
intent.addCategory(Intent.CATEGORY_OPENABLE);
if (intent.resolveActivity(getPackageManager()) != null) {
startActivityForResult(intent, REQUEST_CODE_SELECTED_IMAGE);
} else {
Toast.makeText(this, "未找到可用图库应用", Toast.LENGTH_SHORT).show();
}
}4. 正确处理返回结果（适配 Android 11+ 的 URI 安全性）
@Override
protected void onActivityResult(int requestCode, int resultCode, @Nullable Intent data) {
super.onActivityResult(requestCode, resultCode, data);
if (requestCode == REQUEST_CODE_SELECTED_IMAGE && resultCode == RESULT_OK && data != null) {
Uri selectedImageUri = data.getData();
if (selectedImageUri != null) {
try {
// 推荐：使用 ContentResolver 安全读取（自动适配 Scoped Storage）
InputStream inputStream = getContentResolver().openInputStream(selectedImageUri);
Bitmap bitmap = BitmapFactory.decodeStream(inputStream);
// ✅ 此方式在 Android 11+ 下完全合法，无需任何权限
// 后续可上传、压缩或显示 bitmap
} catch (FileNotFoundException e) {
Toast.makeText(this, "图片读取失败", Toast.LENGTH_SHORT).show();
}
}
}
}? 关键原理说明
- Intent.ACTION_PICK 是系统级契约行为，由图库 App（如 Google Photos、三星图库）响应，返回的是 content:// URI（非 file://），天然受 Android 10+ Scoped Storage 保护。
- content:// URI 通过 ContentResolver 访问时，系统自动授予临时读取权限（FLAG_GRANT_READ_URI_PERMISSION），开发者无需声明或请求 READ_EXTERNAL_STORAGE。
- maxSdkVersion="29" 是旧版适配遗留，现已过时；Android 11+ 应转向以 Intent 为中心的媒体访问范式。
? 最佳实践总结
- ✅ 永远不要为 ACTION_PICK 请求 READ_EXTERNAL_STORAGE（Android 10+ 无效，Android 11+ 可能违规）
- ✅ 使用 setDataAndType(..., "image/*") + addCategory(Intent.CATEGORY_OPENABLE) 提升兼容性
- ✅ 在 onActivityResult 中用 getContentResolver().openInputStream(uri) 安全读取，避免 File API
- ✅ 若需多图选择，改用 Intent.ACTION_GET_CONTENT（支持 Intent.EXTRA_ALLOW_MULTIPLE）
遵循以上方案，你的应用将无缝支持 Android 8.0 至 Android 14 的图库图片选取，同时满足 Google Play 的隐私合规要求。
