Android应用无法弹出READ_EXTERNAL_STORAGE权限授权弹窗的解决办法

1. 适配Android 13+的权限变更 #

从Android 13（API 33）开始，READ_EXTERNAL_STORAGE权限已被废弃，系统不再响应该权限的请求。针对媒体文件访问，需使用细分的权限：

• 访问图片：READ_MEDIA_IMAGES
• 访问视频：READ_MEDIA_VIDEO
• 访问音频：READ_MEDIA_AUDIO

适配后的Manifest声明 #

根据目标SDK版本，在Manifest中添加对应权限：

<!-- 针对API 32及以下版本 -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
    android:maxSdkVersion="32" />

<!-- 针对API 33及以上版本 -->
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />

代码中动态请求适配 #

根据系统版本判断要请求的权限：

// 定义要请求的权限数组
String[] requestPermissions;
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
    // Android 13+，按需选择对应媒体权限
    requestPermissions = new String[]{Manifest.permission.READ_MEDIA_IMAGES};
} else {
    // Android 12及以下
    requestPermissions = new String[]{Manifest.permission.READ_EXTERNAL_STORAGE};
}

2. 修复权限请求逻辑的分支漏洞 #

你的requestPermission方法中，shouldShowRequestPermissionRationale返回true时无任何处理，会导致用户之前拒绝过权限但未勾选"不再询问"时，直接跳过权限请求，不弹出弹窗。需在该分支添加权限解释逻辑后再发起请求：

private void requestPermission(){
    String permission = requestPermissions[0];
    if (ContextCompat.checkSelfPermission(this, permission) == PackageManager.PERMISSION_GRANTED){
        isGranted = true;
    }else {
        if (shouldShowRequestPermissionRationale(permission)){
            // 向用户解释权限用途
            new AlertDialog.Builder(this)
                .setTitle("需要存储权限")
                .setMessage("应用需要访问媒体文件以正常运行，请授予权限")
                .setPositiveButton("确定", (dialog, which) -> {
                    // 解释后发起权限请求
                    resultLauncher.launch(permission);
                })
                .setNegativeButton("取消", null)
                .show();
        }else {
            resultLauncher.launch(permission);
        }
    }
}

3. 确认ActivityResultLauncher的注册时机 #

registerForActivityResult必须在Activity生命周期早期调用（比如onCreate方法内或类初始化阶段），不能在requestPermission等方法中延迟注册，否则会导致请求无法触发弹窗。确保你的resultLauncher是在Activity成员变量中初始化，或在onCreate方法中注册。

4. 处理权限被永久拒绝的场景 #

如果用户之前勾选了"不再询问"并拒绝权限，或在系统设置中直接禁用了权限，此时权限请求不会弹出弹窗。你的代码中已调用sendToSettingsDialog引导用户到设置开启权限，需确保该方法正常工作：

private void sendToSettingsDialog(){
    new AlertDialog.Builder(this)
        .setTitle("权限被禁用")
        .setMessage("请在设置中开启存储权限，否则应用无法正常运行")
        .setPositiveButton("去设置", (dialog, which) -> {
            // 跳转到应用设置页面
            Intent intent = new Intent(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
            Uri uri = Uri.fromParts("package", getPackageName(), null);
            intent.setData(uri);
            startActivity(intent);
        })
        .setNegativeButton("取消", null)
        .show();
}

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