You need to enable JavaScript to run this app. 使用react-native-fs可读取/storage但读/storage/emulated报空数组长度错误
优惠活动
大模型
产品
解决方案
定价
更多

使用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权限声明,运行时动态申请该权限,替代已废弃的旧全局存储权限
  • 适配SD卡访问逻辑:如需遍历外部SD卡内容,不能直接依赖react-native-fs的原生readDir方法读取原始SD卡路径,需要通过SAF框架获取SD卡的访问授权,将SAF返回的uri转换为可被RNFS识别的有效路径后再执行枚举操作。

内容的提问来源于stack exchange,提问作者Verysmartnick

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 16:15:03