Android11下react-native-fs重装后无法操作Download目录文件求助

问题原因 #

Android 11的Scoped Storage机制对公共存储访问做了严格限制：

• 应用在公共目录（如Download）下创建的自定义子目录（如AppName）会被标记为应用私有公共目录，卸载后文件所有权仍绑定原应用的权限上下文。
• 重装后的应用即便包名相同，也无法直接通过文件路径访问这些私有公共目录下的文件，哪怕申请了READ_EXTERNAL_STORAGE和WRITE_EXTERNAL_STORAGE权限。
• preserveLegacyExternalStorage仅适用于应用从Android 10及以下升级到Android 11的场景，卸载重装时完全失效。
• targetSdkVersion 31下，WRITE_EXTERNAL_STORAGE权限已被弱化，申请该权限仅会授予读权限，无法获得完整写入权限。

解决方案 #

方案1：通过MediaStore API访问文件 #

Download目录下的文件属于MediaStore的Downloads集合，通过MediaStore查询可绕过路径访问的权限限制：

1. 在React Native中集成原生模块或使用第三方库（如react-native-media-store），查询MediaStore.Downloads中属于AppName目录下的文件。
2. 获取文件的content://格式URI，而非直接使用文件路径。
3. 使用RNFS的API（如RNFS.readFile、RNFS.copyFile）操作该URI（RNFS支持部分content:// URI操作，若不支持可在原生层处理文件读写）。

示例原生Kotlin代码查询目标文件：

val projection = arrayOf(
    MediaStore.Downloads._ID,
    MediaStore.Downloads.DISPLAY_NAME,
    MediaStore.Downloads.RELATIVE_PATH
)
val selection = "${MediaStore.Downloads.RELATIVE_PATH} LIKE ?"
val selectionArgs = arrayOf("%AppName/%")
val cursor = contentResolver.query(
    MediaStore.Downloads.EXTERNAL_CONTENT_URI,
    projection,
    selection,
    selectionArgs,
    null
)
cursor?.use {
    while (it.moveToNext()) {
        val id = it.getLong(it.getColumnIndexOrThrow(MediaStore.Downloads._ID))
        val contentUri = ContentUris.withAppendedId(MediaStore.Downloads.EXTERNAL_CONTENT_URI, id)
        // 将contentUri传递给RN层使用
    }
}

方案2：使用存储访问框架(SAF)获取持久化授权 #

通过SAF让用户手动授权访问目标目录，授权是持久化的，重装后重新请求授权即可恢复访问：

1. 在原生层实现SAF目录选择逻辑，引导用户选择/storage/emulated/0/Download/AppName目录。
2. 调用contentResolver.takePersistableUriPermission()保存持久化授权。
3. 后续通过SAF的URI操作文件，重装应用后再次触发SAF选择流程，用户确认后即可访问原有文件。

方案3：调整存储路径，避免私有子目录 #

将文件直接存储在Download根目录（不创建AppName子目录），文件将变为公共可访问资源：

• 存储路径改为RNFS.DownloadDirectoryPath（不添加子目录）。
• 重装后，应用可通过MediaStore查询到这些文件，或在开启requestLegacyExternalStorage的前提下直接通过路径访问（需符合Android 11的Scoped Storage规则）。

额外注意事项 #

• 若必须使用完整外部存储访问权限，可申请MANAGE_EXTERNAL_STORAGE特殊权限，但该权限需要用户跳转到系统设置手动开启，且Google Play可能限制该权限的使用（仅适用于文件管理器类应用）。
• 确保RNFS版本适配Android 11，当前使用的2.20.0版本已支持Scoped Storage，若存在兼容性问题可尝试升级到最新版本。

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