Android11创建文件目录为何提示权限拒绝？

Question

在Android 11中，应用尝试创建文件目录时提示“权限拒绝”，常见原因包括：未正确申请`MANAGE_EXTERNAL_STORAGE`权限，或未启用“所有文件访问权限”；使用了过时的`Environment.getExternalStorageDirectory()`等API；未在清单文件中声明权限；或目标路径属于受系统保护的目录。此外，从Android 10开始加强了对存储的限制，Scoped Storage机制也会影响文件操作权限。解决方法包括：在设置中手动授予“所有文件访问权限”，使用`MediaStore`或`Storage Access Framework`访问公共目录，或使用应用私有目录（如`getExternalFilesDir()`）。

Answer 1

一、Android 11中文件操作权限限制的背景

从Android 10开始，Google引入了Scoped Storage机制，旨在提升用户隐私保护和系统安全性。这一机制限制了应用对设备文件系统的自由访问，尤其是对外部存储的访问权限。在Android 11中，这种限制进一步加强，导致很多旧版本中可以正常运行的文件操作代码在新版本中出现“权限拒绝”的错误。

开发者在尝试创建文件或目录时，若未遵循新的权限模型，往往会在运行时抛出java.io.IOException: Permission denied异常。

二、常见原因分析

• 未申请MANAGE_EXTERNAL_STORAGE权限：此权限是访问设备上所有文件（包括非应用私有目录）的必要条件。
• 未启用“所有文件访问权限”：即使申请了权限，也必须在应用设置中手动开启。
• 使用了过时API：如Environment.getExternalStorageDirectory()已被废弃，不再适用于Android 10及以上。
• 未在AndroidManifest.xml中声明权限：如未添加<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>。
• 目标路径受系统保护：如系统目录、其他应用私有目录等，普通应用无权操作。

三、权限模型与Scoped Storage机制详解

Scoped Storage的核心思想是“按需访问”，即应用只能访问特定目录下的文件，除非获得特殊权限。主要分为：

访问类型	适用场景	权限要求
私有目录	仅限本应用内部使用	无需额外权限
MediaStore	访问媒体文件（图片、视频、音频）	READ/WRITE_MEDIA权限
Storage Access Framework (SAF)	用户选择的文件或目录	通过Intent获取URI权限
MANAGE_EXTERNAL_STORAGE	访问所有文件（如文件管理器类应用）	需申请并用户手动授权

四、解决方案与最佳实践

1. 使用应用私有目录：调用getExternalFilesDir()或getCacheDir()，无需权限即可读写。
2. 使用MediaStore API：适用于访问图片、视频、音频等公共媒体文件。
3. 使用Storage Access Framework (SAF)：通过Intent.ACTION_OPEN_DOCUMENT让用户选择文件或目录。
4. 申请MANAGE_EXTERNAL_STORAGE权限：

   if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
       if (!Environment.isExternalStorageManager()) {
           Intent intent = new Intent(Settings.ACTION_MANAGE_APP_STORAGE);
           startActivity(intent);
       }
   }

五、代码示例与流程图

以下是一个使用SAF让用户选择目录并创建子目录的示例流程：

Intent intent = new Intent(Intent.ACTION_OPEN_DOCUMENT_TREE);
startActivityForResult(intent, REQUEST_CODE_OPEN_DIRECTORY);

在onActivityResult()中获取URI后，使用DocumentFile进行操作：

DocumentFile pickedDir = DocumentFile.fromTreeUri(this, treeUri);
DocumentFile newDir = pickedDir.createDirectory("MyNewFolder");

graph TD
    A[用户点击创建目录] --> B{是否已有权限?}
    B -- 是 --> C[直接操作]
    B -- 否 --> D[请求权限]
    D --> E[用户授权后继续]
    E --> F[使用DocumentFile创建目录]