应用设置中无法显示已声明存储权限的问题求助

根据你提供的Manifest文件和截图，我来帮你梳理可能的原因和对应的解决方案：

核心诱因：Android 10+的分区存储（Scoped Storage）机制变更 #

从Android 10（API 29）开始，系统默认启用分区存储，这一设计彻底重构了应用访问外部存储的逻辑，同时直接影响了存储权限在系统设置中的显示：

• 当你的应用targetSdkVersion >=29时，哪怕在Manifest里声明了WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE，系统也会默认隐藏这两个权限的开关（和你截图里的情况完全吻合）。
• 分区存储模式下，应用无需传统存储权限就能访问自身专属目录，也能通过媒体库API访问公共媒体文件，这就是系统隐藏权限开关的原因。

针对性解决方案 #

1. 先确认项目的targetSdkVersion #

先检查你项目配置里的targetSdkVersion，如果是29或更高版本，那基本可以确定是分区存储导致的权限隐藏。

2. 临时恢复传统存储权限显示（适用于未完成迁移的应用） #

如果你的应用还没做好分区存储的迁移，可以通过以下配置临时恢复权限开关：

• 针对Android 10（API 29）：在Manifest的<application>标签中添加android:requestLegacyExternalStorage="true"，强制禁用分区存储：

<application
    android:name=".ui.MyApplication"
    android:allowBackup="true"
    android:icon="@mipmap/app_icon"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/app_icon"
    android:supportsRtl="true"
    android:requestLegacyExternalStorage="true"> <!-- 新增这一行 -->
    <!-- 其他组件配置 -->
</application>

• 针对Android 11+（API 30及以上）：requestLegacyExternalStorage会失效，只能使用android:preserveLegacyExternalStorage="true"，但这个属性仅对从旧版本升级的应用生效，全新安装的应用无法使用。如果是新开发的应用，建议直接迁移到分区存储。

3. 迁移到分区存储（官方推荐的长期方案） #

这是Android官方主推的方向，你可以按照以下逻辑调整：

• 访问应用专属目录：无需任何权限，直接调用getExternalFilesDir()等方法即可。
• 访问公共媒体文件：使用MediaStore API，Android 10+无需WRITE_EXTERNAL_STORAGE权限。
• 访问非媒体类公共文件：通过系统文件选择器（如ACTION_OPEN_DOCUMENT）让用户手动选择。

4. 确认动态权限申请代码的正确性 #

哪怕权限在设置中不显示，也要确保你的动态申请逻辑没有问题，示例代码如下：

private static final int REQUEST_STORAGE_PERM = 101;

// 检查并申请权限
public void checkStoragePermission() {
    if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
            != PackageManager.PERMISSION_GRANTED) {
        ActivityCompat.requestPermissions(this,
                new String[]{Manifest.permission.WRITE_EXTERNAL_STORAGE},
                REQUEST_STORAGE_PERM);
    }
}

// 处理权限回调
@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
    super.onRequestPermissionsResult(requestCode, permissions, grantResults);
    if (requestCode == REQUEST_STORAGE_PERM) {
        if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            // 权限授予成功，执行后续操作
        } else {
            // 权限被拒绝，可提示用户开启权限
        }
    }
}

特殊场景说明 #

如果你的应用需要访问整个外部存储（比如文件管理器类应用），可以申请MANAGE_EXTERNAL_STORAGE权限，但这是特殊权限，需要引导用户手动跳转到系统设置开启，且必须通过谷歌Play的专项审核（仅允许特定类型的应用使用）。

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