Android 13自定义隐藏目录listFiles()返回null问题求助

核心原因 #

Android 11及以上系统启用了分区存储（Scoped Storage），默认限制通过File API直接访问外置存储上的非应用专属目录——哪怕是你自行创建的自定义目录也不例外。你添加的READ_MEDIA_IMAGES/VIDEO权限仅适用于媒体库管理的标准媒体文件，无法覆盖自定义隐藏目录的访问需求。

具体解决方案 #

1. 申请全存储访问权限（仅适用于文件管理器类场景） #

如果你的应用确实需要全量访问外置存储，可申请MANAGE_EXTERNAL_STORAGE权限：

• 在Manifest中添加权限声明：

  <uses-permission android:name="android.permission.MANAGE_EXTERNAL_STORAGE"
                   android:minSdkVersion="30" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"
                   android:maxSdkVersion="29" />
  

• 代码中动态引导用户授权：

  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
      if (!Environment.isExternalStorageManager()) {
          Intent intent = new Intent(Settings.ACTION_MANAGE_ALL_FILES_ACCESS_PERMISSION);
          startActivity(intent);
      } else {
          // 权限已获取，可正常使用File API访问目标目录
          String SRC_PATH = Environment.getExternalStorageDirectory().toString() + "/somePath/";
          File directory = new File(SRC_PATH);
          File[] files = directory.listFiles();
          // 处理文件列表逻辑
      }
  }
  

  注意：该权限需在应用商店审核时说明合理用途，否则可能被拒。

2. 迁移到应用专属存储（推荐方案） #

如果自定义目录是你的应用创建的，优先迁移到应用专属外部存储目录，无需额外权限：

// 获取应用专属的隐藏目录（路径类似：/sdcard/Android/data/包名/files/.somePath）
File appHiddenDir = new File(getExternalFilesDir(null), ".somePath");
if (!appHiddenDir.exists()) {
    appHiddenDir.mkdirs();
}
File[] files = appHiddenDir.listFiles();

应用专属目录下的文件会随应用卸载自动删除，且不受分区存储限制，安全性更高。

3. 用MediaStore API访问媒体文件（局限方案） #

如果自定义目录内是图片/视频等媒体文件，可通过MediaStore扫描后访问，但隐藏目录下的文件默认不会被索引，需手动触发扫描：

// 触发媒体扫描，让系统识别隐藏目录内的文件
MediaScannerConnection.scanFile(this,
        new String[]{SRC_PATH},
        null,
        (path, uri) -> {
            // 扫描完成后通过ContentResolver查询
            Cursor cursor = getContentResolver().query(
                    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                    null,
                    MediaStore.Images.Media.DATA + " LIKE ?",
                    new String[]{"%/somePath/%"},
                    null);
            // 处理查询结果
        });

此方式仅适用于媒体文件，对非媒体文件无效，不推荐作为核心方案。

额外排查点 #

• 确认目录有效性：调用directory.exists()和directory.isDirectory()判断目录是否真实存在，若返回false则路径有误或目录未创建。
• 检查读取权限：打印directory.canRead()的结果，确认文件系统层面是否允许读取该目录。

内容的提问来源于stack exchange，提问作者raul g h