Android 11（API 30）下context.getExternalFilesDirs(null)无法获取SD卡目录的解决方案咨询

咱们来拆解下你遇到的问题：在API 29模拟器能拿到SD卡的应用专属目录，但API 30模拟器不行，而且你需要访问SD卡非媒体文件并使用listFiles()。核心原因是Android 11（API 30）对外部存储权限做了进一步收紧——哪怕你设置了targetSdkVersion=29和requestLegacyExternalStorage="true"，可移动存储的访问规则还是发生了变化。下面分两种场景给你具体方案：

场景1：访问SD卡上的应用专属目录（推荐） #

这是最合规的方式，因为这个目录属于应用私有空间，不需要额外权限，系统也不会限制：

1. 先确认你的Nexus 4 API 30模拟器已经挂载了SD卡——进入模拟器设置 → 存储 → 添加SD卡镜像即可。
2. 遍历getExternalFilesDirs(null)返回的数组，筛选出可移动存储的目录：

   File[] contextDirs = context.getExternalFilesDirs(null);
   for (File dir : contextDirs) {
       if (dir != null && Environment.isExternalStorageRemovable(dir)) {
           // 找到SD卡上的应用专属目录了
           // 直接调用listFiles()操作子目录完全没问题
           File[] subDirFiles = dir.listFiles();
           // 这里写你的文件处理逻辑
       }
   }
   

API 30+哪怕用legacy模式，应用对自己的专属目录依然拥有完整读写权限，放心用就行。

场景2：访问SD卡上的非应用专属目录（比如根目录、其他公共目录） #

如果必须访问应用专属目录以外的非媒体文件，就得用特殊权限了：

1. 先在AndroidManifest.xml里声明权限：

   <!-- API 30+需要的全存储访问权限 -->
   <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
                   android:minSdkVersion="30" />
   <!-- API 29及以下保留原有权限 -->
   <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"
                   android:maxSdkVersion="29" />
   

2. 在代码里检查并请求权限：

   private static final int REQUEST_CODE_MANAGE_STORAGE = 1001;
   
   // 检查权限并跳转授权
   private void checkStoragePermission() {
       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_CODE_MANAGE_STORAGE);
           } else {
               // 已经拿到权限，可访问SD卡任意非媒体文件
               File sdCardRoot = new File("/storage/11EC-1206"); // 替换成你的SD卡UUID路径
               File[] rootFiles = sdCardRoot.listFiles();
               // 处理文件逻辑
           }
       } else {
           // API 29及以下，只要申请过WRITE_EXTERNAL_STORAGE就能访问
           if (ContextCompat.checkSelfPermission(this, Manifest.permission.WRITE_EXTERNAL_STORAGE)
                   == PackageManager.PERMISSION_GRANTED) {
               File sdCardRoot = Environment.getExternalStorageDirectory();
               File[] rootFiles = sdCardRoot.listFiles();
               // 处理文件逻辑
           }
       }
   }
   

⚠️ 注意：MANAGE_EXTERNAL_STORAGE权限需要用户手动跳转到系统设置授权，而且谷歌Play商店对使用该权限的应用审核极严，只有文件管理器、备份工具这类刚需应用才会通过审核，非必要别用。

额外提醒 #

• 优先用应用专属目录，不仅合规，还能避免权限问题，而且卸载应用时这些文件会被自动清理。
• API 29+尽量别用Environment.getExternalStorageDirectory()，这个方法已经过时了，推荐用getExternalFilesDirs()来获取存储路径。

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