React Native Android应用专属目录文件无法访问问题排查

两个异常本质是Android分区存储（Scoped Storage）适配错误+文件路径拼接逻辑错误，和之前执行的adb调试命令无关，和PDF模块代码逻辑也无直接冲突。 #

针对两个疑问的直接解答 #

1. 为什么其他应用专属目录能被文件管理器识别，你的应用不行？ #

Android 11及以上版本中，应用专属外部存储目录（/storage/emulated/0/Android/data/<包名>/）默认对其他应用、系统文件管理器不可见——你看到其他应用的目录能被浏览，只有两种可能：

• 那些应用的targetSdkVersion低于30，且开启了requestLegacyExternalStorage标记，获得了旧版存储权限
• 你用的文件管理器持有全存储特权权限，同时目标应用主动将文件标记为可共享
  你的应用目录无法被检索，核心是存文件的路径拼接错误，把内部存储路径拼到了外部专属目录下形成了嵌套冗余路径，且没有触发系统媒体扫描，文件自然不会被索引。

2. 当前Android配置的错误/遗漏项 #

• 路径逻辑错误：你存PDF的路径/storage/emulated/0/Android/data/packageName/files/data/user/0/packageName/files/fileName.pdf是典型拼接bug，把应用内部私有存储的路径（/data/user/0/packageName/files/）硬拼到了外部专属存储路径后面，属于无效嵌套路径，系统不会扫描这类异常路径下的文件
• 权限适配缺失：你只加了READ/WRITE_EXTERNAL_STORAGE权限，但targetSdkVersion>=33时这两个权限已经失效，读取媒体文件需要对应细分媒体权限；如果要让其他应用访问你存到公共目录的文件，需要主动触发媒体扫描，而不是只完成文件写入操作
• filepaths.xml配置错误：你配置的<root-path name="root" path="." />属于违规配置，Android 7.0以上FileProvider不允许直接暴露根路径，会导致跨应用文件访问（包括axios上传时读取文件、系统文件管理器访问）直接失败
• 图片上传报错的直接原因：react-native-image-crop-picker返回的图片如果存到你应用的专属外部目录，axios发起上传时需要通过FileProvider生成可访问的content:// uri，你直接传file://路径，系统在分区存储规则下没有权限读取专属目录的跨进程文件，直接返回找不到文件的错误，被axios包装成Network error

修复步骤 #

• 修复文件路径拼接逻辑
  用react-native-fs获取路径时不要硬编码，下载PDF如果要让文件管理器可见，直接存到公共下载目录：

  const downloadPath = Platform.OS === 'android' ? `${RNFS.DownloadDirectoryPath}/你的应用文件夹名` : RNFS.DocumentDirectoryPath
  

  不要把内部存储路径拼到外部路径下，专属目录的正确路径直接用RNFS.ExternalDirectoryPath获取即可，不要自行拼接多层嵌套子路径。
• 修正权限配置
  如果targetSdkVersion >=33（Android 13），删掉旧的WRITE_EXTERNAL_STORAGE权限，在AndroidManifest.xml里加对应细分权限：

  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
  

  动态权限申请逻辑也要同步适配，Android13以上申请READ_MEDIA_IMAGES，Android12及以下才申请READ/WRITE_EXTERNAL_STORAGE。
• 修正filepaths.xml配置
  删掉违规的root-path配置，按实际需要配置可暴露的路径：

  <?xml version="1.0" encoding="utf-8"?>
  <paths xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 公共下载目录 -->
    <external-path name="downloads" path="Download/" />
    <!-- 应用专属外部目录 -->
    <external-files-path name="app_external" path="." />
    <!-- 应用内部目录 -->
    <files-path name="app_internal" path="." />
    <!-- 公共图片目录 -->
    <external-path name="pictures" path="Pictures/" />
  </paths>
  

  确认AndroidManifest.xml里的FileProvider配置和该filepaths.xml正确关联，不要漏配FileProvider。
• 修复图片上传的uri传参
  从react-native-image-crop-picker拿到图片路径后，如果是file://开头的专属目录路径，不要直接传给axios，先通过FileProvider转成content:// uri，或者把选择的图片临时复制到应用内部缓存目录再上传，避免跨进程文件访问权限问题。
• 文件写入完成后主动触发媒体扫描
  不管是下载的PDF还是存储的图片，只要写到公共目录，写完就调用系统媒体扫描接口，把文件加入系统媒体库，文件管理器就能立刻检索到：

  // 文件写入完成后调用
  RNFS.scanFile(filePath)
  

验证流程 #

1. 执行cd android && ./gradlew clean全量清理构建缓存，卸载测试机上的旧应用再重新安装，避免旧权限缓存影响结果
2. 测试图片选择上传流程，确认日志不再报找不到文件的错误
3. 下载PDF到公共下载目录，写完触发媒体扫描，打开系统文件管理器的下载分类即可看到对应文件

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