Flutter无法读取已授权的WhatsApp隐藏目录文件问题

问题详情 #

通过ACTION_OPEN_DOCUMENT_TREE让用户选择文件夹（以此规避MANAGE_EXTERNAL_STORAGE权限），但无法读取隐藏目录/storage/emulated/0/Android/media/com.whatsapp/WhatsApp/Media/.Statuses内的文件。已添加以下URI权限：

intent.addFlags(Intent.FLAG_GRANT_WRITE_URI_PERMISSION)
intent.addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
intent.addFlags(Intent.FLAG_GRANT_PREFIX_URI_PERMISSION)
intent.addFlags(Intent.FLAG_GRANT_PERSISTABLE_URI_PERMISSION)

原生代码能列出目录文件并正常访问，但传递给Flutter的Content URI（如下示例）无法用Image.file()读取：

content://com.android.externalstorage.documents/tree/primary%3AAndroid%2Fmedia%2Fcom.whatsapp%2FWhatsApp%2FMedia%2F.Statuses/document/primary%3AAndroid%2Fmedia%2Fcom.whatsapp%2FWhatsApp%2FMedia%2F.Statuses%2Fa9e8797092cd4bfeb6e426dfa1be7a84.jpg

核心原因 #

Flutter的Image.file()仅支持本地文件路径，而content://开头的是Android文档提供器的URI格式，并非直接的文件系统路径，因此无法直接加载。

解决方法 #

方法1：将Content URI转为应用私有临时文件 #

在原生代码中读取Content URI对应的文件流，复制到应用缓存目录的临时文件，再将临时文件路径传给Flutter。

1. 添加URI转临时文件的工具方法：

fun getTempFilePathFromContentUri(context: Context, uri: Uri): String? {
    return try {
        val inputStream = context.contentResolver.openInputStream(uri) ?: return null
        val tempFile = File(context.cacheDir, "temp_img_${System.currentTimeMillis()}.jpg")
        val outputStream = FileOutputStream(tempFile)
        
        inputStream.copyTo(outputStream, bufferSize = 4096)
        
        inputStream.close()
        outputStream.close()
        
        tempFile.absolutePath
    } catch (e: Exception) {
        e.printStackTrace()
        null
    }
}

2. 修改getData()方法中添加文件的逻辑：

// 替换原代码中的filesList.add(fromTreeUri1.uri.toString())
val tempPath = getTempFilePathFromContentUri(this@MainActivity, fromTreeUri1.uri)
if (tempPath != null) {
    filesList.add(tempPath)
}

3. 临时文件清理：在Flutter页面销毁或应用退出时，调用原生方法删除缓存目录下的临时文件，避免占用存储空间。

方法2：直接用Image.network加载Content URI（API 29+） #

Android 10及以上支持直接通过Content URI加载资源，Flutter的Image.network()可兼容该格式，需添加空header绕过网络解析逻辑：

Image.network(
  yourContentUriString,
  headers: const {"Authorization": ""},
  errorBuilder: (context, error, stackTrace) {
    return const Icon(Icons.error_outline);
  },
)

方法3：使用Flutter插件处理Content URI #

部分文件操作插件（如flutter_document_picker）支持直接处理Content URI，可调用插件API获取文件流后加载图片。

额外注意事项 #

• 确保takePersistableUriPermission调用正确，持久化URI权限，避免应用重启后丢失访问权。
• 测试原生代码中contentResolver.openInputStream(uri)是否能正常读取文件流，排除权限异常问题。
• 临时文件需定期清理，可在应用启动或退出时执行清理逻辑。

内容的提问来源于stack exchange，提问作者Syed Usama Ahmad