如何在 Android 11（API 30+）及以下版本中统一安全选择图库图片-java教程-PHP中文网

本文详解如何在 android 11 及更高版本（scoped storage 强制启用）与 android 10 及以下版本中，兼容性地从系统图库选取图片，避免因权限配置错误导致功能失效。

本文详解如何在 android 11 及更高版本（scoped storage 强制启用）与 android 10 及以下版本中，兼容性地从系统图库选取图片，避免因权限配置错误导致功能失效。

在 Android 11（API 级别 30）及更高版本中，Google 全面推行 分区存储（Scoped Storage） 机制，大幅限制应用对共享外部存储（如 DCIM、Pictures 目录）的直接访问。这意味着：

READ_EXTERNAL_STORAGE 权限在 Android 11+ 上默认不再授予对媒体文件的广泛读取能力；
即使声明了该权限，Intent.ACTION_PICK 仍可正常工作——但前提是权限声明本身不能被 android:maxSdkVersion="29" 错误限制。

❌ 常见错误：滥用 maxSdkVersion

你在 AndroidManifest.xml 中写入：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxsdkversion="29"></uses-permission>

这个配置会导致：
? 在 Android 11+ 设备上，该权限根本不会被系统授予（即使用户同意），因为系统认为它“不适用于此 SDK 版本”；
? ContextCompat.checkSelfPermission() 检查将始终返回 PERMISSION_DENIED，后续 selectImage() 不会被调用；
? 最终表现为“点击无响应”或“仅低版本可用”，与你描述的现象完全一致。

✅ 正确做法：移除 maxSdkVersion，依赖 Intent + 运行时权限协同

1. 清理 Manifest 权限声明

删除 maxSdkVersion 属性，保留基础声明即可（兼容所有版本）：

<!-- AndroidManifest.xml -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"></uses-permission><!-- 注意：Android 11+ 不再需要 WRITE 权限来读取图库图片 -->

⚠️ 补充说明：自 Android 13（API 33）起，READ_MEDIA_IMAGES 成为读取图片的推荐权限，但 ACTION_PICK 方式无需任何运行时权限（系统图库 Activity 自行处理访问）。因此，为最大兼容性（支持 Android 5.0+），继续使用 ACTION_PICK 是最稳妥方案，无需适配 READ_MEDIA_IMAGES。

2. 优化 Java/Kotlin 代码逻辑

你的 selectImage() 逻辑本质正确，但需微调权限判断逻辑以适配新行为：

// 推荐：仅在 Android 9（API 28）及以下才强制请求 READ_EXTERNAL_STORAGE
// Android 10+ 使用 ACTION_PICK 无需该权限（系统自动授权）
private void selectImage() {
    Intent intent = new Intent(Intent.ACTION_PICK, MediaStore.Images.Media.EXTERNAL_CONTENT_URI);
    intent.setType("image/*");
    if (intent.resolveActivity(getPackageManager()) != null) {
        startActivityForResult(intent, REQUEST_CODE_SELECTED_IMAGE);
    } else {
        Toast.makeText(this, "未找到可用图库应用", Toast.LENGTH_SHORT).show();
    }
}

// 点击事件中：仅对旧系统请求权限，新系统直接启动
layoutMiscellaneous.findViewById(R.id.laoutAddImage).setOnClickListener(view -> {
    bottomSheetBehavior.setState(BottomSheetBehavior.STATE_COLLAPSED);

    // Android 10 及以下需动态申请权限；Android 11+ 可跳过权限检查直接调用
    if (Build.VERSION.SDK_INT <h4>3. 权限回调保持简洁</h4><p>onRequestPermissionsResult 仅需处理旧版本授权结果：</p><pre class="brush:php;toolbar:false;">@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();
        }
    }
}

✅ 验证与最佳实践总结

项目	推荐方案
目标 API	targetSdkVersion 33 或 34（务必更新）
核心 Intent	Intent.ACTION_PICK + MediaStore.Images.Media.EXTERNAL_CONTENT_URI（兼容性最强）
是否需要 READ_MEDIA_IMAGES？	❌ 否 —— ACTION_PICK 绕过权限限制，无需声明或请求
maxSdkVersion	❌ 必须移除，否则高版本权限失效
测试覆盖	✅ Android 8.0（API 26）、Android 10（29）、Android 12（31）、Android 14（34）