Android模拟器中listFiles返回空数组，单个文件却存在的问题求助

兄弟，这个问题我之前踩过类似的坑，结合Android存储的权限机制和模拟器的特性，给你梳理几个最可能的原因：

1. Android 10+ 分区存储（Scoped Storage）的限制 #

从Android 10（API 29）开始，系统默认启用分区存储，即使你申请了READ_EXTERNAL_STORAGE权限，你的App也不能直接通过File API访问外部存储上的自定义目录（比如你创建的/sdcard/Books/LadySusan）。

这种情况下，单个文件能通过exists()检测到存在，大概率是因为你通过adb或者其他模拟器工具把文件传进去的，但App没有读取该目录内容的权限，所以listFiles()返回空数组（注意：返回空数组表示目录存在但App无法读取内容，返回null才是目录不存在或完全无权限）。

解决办法：

• 针对API 29-30，可以在AndroidManifest.xml的<application>标签里添加android:requestLegacyExternalStorage="true"，暂时禁用分区存储；
• 针对API 31+，建议改用MediaStore API来查询目录下的文件，或者将文件放在App专属的外部存储目录（getExternalFilesDir()）。

2. Linux文件系统的权限问题 #

你通过模拟器上传的文件/目录，其Linux层面的权限可能没有开放给你的App进程。比如用adb push上传的文件，Owner通常是root或shell，而你的App运行在独立的用户组下，没有读取目录内容的权限。

你可以通过adb shell执行以下命令查看权限：

ls -l /sdcard/Books/LadySusan

如果目录的权限是drwxr--r--（只有Owner有读权限），那其他用户（包括你的App）就无法读取目录内容。这时候可以修改目录权限：

chmod 755 /sdcard/Books/LadySusan

3. 硬编码路径的兼容性问题 #

/sdcard其实是Android系统的软链接，实际指向/storage/emulated/0，虽然大多数情况下访问没问题，但个别模拟器可能存在路径解析的差异。建议你用Android官方提供的API来构建路径，而不是硬编码：

File booksDir = new File(Environment.getExternalStorageDirectory(), "Books/LadySusan");

这样能避免因路径映射问题导致的访问异常。

4. 权限申请未真正生效 #

虽然你说写了权限申请代码，但还是要确认READ_EXTERNAL_STORAGE权限是否真的被授予。可以在调用listFiles()前添加权限检查：

if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_EXTERNAL_STORAGE) 
        != PackageManager.PERMISSION_GRANTED) {
    // 权限未授予，重新申请
    ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.READ_EXTERNAL_STORAGE}, 100);
}

这里要注意：Android 6.0（API 23）及以上需要动态申请危险权限，仅在Manifest里声明是不够的。

5. 模拟器存储缓存或媒体库未刷新 #

部分模拟器存在存储缓存的问题，上传文件后系统媒体库没有及时刷新，导致App无法感知到目录内的文件。你可以尝试：

• 重启模拟器；
• 调用MediaScannerConnection.scanFile()主动刷新文件索引：

MediaScannerConnection.scanFile(this, 
        new String[]{"/sdcard/Books/LadySusan/ladysusan_1_austen_64kb.mp3"}, 
        null, 
        (path, uri) -> { /* 刷新完成回调 */ });

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