使用react-native-fs可读取/storage但读/storage/emulated报空数组长度错误
问题核心成因
- 路径本身不符合安卓存储设计规范:
/storage/emulated是安卓系统为多用户机制设计的虚拟逻辑挂载点,仅作为存储目录的映射标识存在,并非可直接枚举文件的实体目录。调用原生接口读取该路径时,系统会直接返回空值(null)而非合法文件列表,react-native-fs的原生模块未对该返回值做非空判断,直接尝试获取返回数组的长度,就会抛出"Attempt to get length of null array"的报错——这个报错和权限授予状态没有关联。 - 权限适配未覆盖安卓高版本规则:现有Manifest仅声明了适用于安卓9及以下版本的
READ_EXTERNAL_STORAGE权限,从安卓10开始系统引入分区存储限制,安卓13起直接废弃了旧的全局存储权限,替换为按媒体类型划分的细粒度权限。哪怕系统设置界面显示旧权限已授予,实际也无法获得深层存储目录的访问能力。 - 外部SD卡访问机制变更:类似
/storage/0123-4567的SD卡路径,在安卓11及以上版本不再支持传统文件路径的直接全量枚举,必须通过系统存储访问框架(SAF)获取授权后才能访问,直接调用文件读取接口会返回空数组。
落地解决与绕过方案
- 修正目录访问路径:不要直接枚举
/storage/emulated路径,安卓当前用户的主内部存储真实可访问根路径为固定值/storage/emulated/0,替换该路径即可正常读取内部存储内容。之前出现的读取报错,本质是测试时拼接的路径缺失了/0层级,访问到了无文件列表的虚拟映射目录。 - 补齐全安卓版本的权限适配:
- 安卓9(API28及以下):保留现有
READ_EXTERNAL_STORAGE权限的动态申请逻辑 - 安卓10(API29):在Manifest的application标签中添加
android:requestLegacyExternalStorage="true"声明,临时关闭分区存储机制,回归传统文件访问模式 - 安卓13(API33及以上):在Manifest中补充音频类应用需要的
READ_MEDIA_AUDIO权限声明,运行时动态申请该权限,替代已废弃的旧全局存储权限
- 安卓9(API28及以下):保留现有
- 适配SD卡访问逻辑:如需遍历外部SD卡内容,不能直接依赖react-native-fs的原生
readDir方法读取原始SD卡路径,需要通过SAF框架获取SD卡的访问授权,将SAF返回的uri转换为可被RNFS识别的有效路径后再执行枚举操作。
内容的提问来源于stack exchange,提问作者Verysmartnick
相关产品推荐
相关产品推荐

