Android SDK 31中MANAGE_EXTERNAL_STORAGE权限无法生效如何解决？

前置校验：确认SDK版本配置生效 #

• 检查项目主模块以及所有子模块的build.gradle文件，确认compileSdkVersion和targetSdkVersion均已正确设置为31，不存在子模块配置覆盖主模块配置的情况
• 执行clean操作清理项目缓存后重新编译安装，避免旧版本安装包缓存导致的权限校验异常

第一步：校验清单文件声明合规性 #

• 必须在AndroidManifest.xml中显式声明权限，SDK 31版本无需添加额外属性前缀，声明示例：

<uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE" />
<!-- 若无需兼容Android 14及以上版本可添加android:maxSdkVersion="33"限制 -->

• 确认权限声明中未添加android:required="false"属性，避免权限被系统默认跳过申请
• 若应用非文件管理类工具，上架应用市场需要补充权限使用说明，但本地调试阶段不影响权限获取

第二步：检查权限申请流程是否符合系统要求 #

MANAGE_EXTERNAL_STORAGE属于特殊管理类权限，无法通过常规运行时权限接口申请，必须跳转系统专属设置页授权：

• 正确的申请逻辑示例：

// 自定义权限申请请求码
private static final int REQUEST_MANAGE_STORAGE = 1001;

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
    // 先校验是否已经获取权限
    if (!Environment.isExternalStorageManager()) {
        // 必须跳转当前应用的专属授权页，禁止跳转所有应用的权限列表页
        Intent intent = new Intent(Settings.ACTION_MANAGE_APP_ALL_FILES_ACCESS_PERMISSION);
        intent.setData(Uri.parse("package:" + getPackageName()));
        startActivityForResult(intent, REQUEST_MANAGE_STORAGE);
    }
}

• 权限申请结果需要在onActivityResult回调中再次调用Environment.isExternalStorageManager()校验，不要依赖系统返回的resultCode，部分定制ROM返回的结果码存在误差

第三步：排查ROM定制限制导致的异常 #

• 部分国内定制ROM（MIUI、ColorOS、鸿蒙等）对该权限有额外管控，可先手动进入系统设置-应用管理-当前应用-权限管理页面，查看是否存在「所有文件访问权限」选项，手动开启后验证功能是否正常
• 禁止在应用分身、双开环境下测试该权限，双开环境的外部存储隔离机制会导致权限校验失败
• 测试机若开启了USB调试授权验证，需要确认已给当前应用授予了调试相关权限，部分机型会将存储权限与调试权限绑定校验

第四步：业务场景适配优化 #

• 若应用仅需要访问公共目录的图片、视频、音频等媒体文件，建议放弃申请MANAGE_EXTERNAL_STORAGE，改用MediaStoreAPI访问对应资源，无需申请特殊权限
• 不要尝试使用反射、系统漏洞绕过权限申请，Android 12已修复所有已知的绕过方案，且应用商店会直接检测拦截此类行为

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