Flutter使用receive_sharing_intent解析WhatsApp content Uri获取文件路径

• 你拿到的两个content://开头的Uri，本质是安卓跨应用共享文件时的临时访问令牌，不是包含真实路径的链接，这类Uri本身就不存储文件在手机里的实际存储位置，所以用Uri.parse()、Uri.decode()这类只解析Uri本身结构的方法，根本不可能拿到真实路径。
• WhatsApp的共享文件受系统沙盒权限保护，你的应用没有直接读取的权限，必须走安卓规定的内容解析流程才能访问到文件实体。

• 首先安装两个必要的依赖，不需要自己写原生通道处理：
  • permission_handler：用来申请安卓系统要求的媒体/存储读取权限
  • uri_to_file：已经封装好了安卓端ContentResolver查询、临时权限申请、文件转存的全流程，专门适配这类第三方应用分享的content Uri
• 替换你现有拿到Uri后的处理逻辑，直接用插件做转换，示例代码：

  // 你原有获取分享Uri的代码保持不变
  Uri? sharedUri = await ReceiveSharingIntent.getInitialTextAsUri();
  if(sharedUri == null) return;
  
  // 直接调用插件方法把content Uri转成可访问的本地文件
  File? mediaFile = await uriToFile(
    sharedUri,
    isMedia: true, // 适配WhatsApp这类应用分享的图片/视频类内容
  );
  
  if(mediaFile != null) {
    // 这里拿到的mediaFile.path就是可直接使用的真实文件路径
    String realFilePath = mediaFile.path;
  }
  

• 安卓端必须补的配置，不然会出现权限报错：
  1. 在android/app/src/main/AndroidManifest.xml的<application>节点同级添加对应权限：

     <!-- 适配安卓13以下的存储读取权限 -->
     <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32"/>
     <!-- 适配安卓13及以上的媒体分类读取权限 -->
     <uses-permission android:name="android.permission.READ_MEDIA_IMAGES"/>
     <uses-permission android:name="android.permission.READ_MEDIA_VIDEO"/>
     

  2. 针对你提到的先后收到两个结构几乎一致的WhatsApp Uri的问题，可以加个简单的去重逻辑，避免重复处理同一个文件：

     // 把Uri转成字符串后去掉首尾空格做规范化，和之前缓存的Uri对比，重复就跳过
     String normalizedUri = sharedUri.toString().trim();
     if(_lastProcessedUri == normalizedUri) return;
     _lastProcessedUri = normalizedUri;
     

• 这类第三方分享的content Uri是临时的，仅在当前接收分享的会话有效期内可用，应用退出后这个Uri就会失效，拿到文件后建议第一时间转存到应用自己的私有目录，不要只存Uri字符串。
• 不要尝试手动截取Uri里的uuid段当文件路径，新版本WhatsApp的provider路径结构会随版本调整（就是你遇到的两个路径差了斜杠的情况），和真实存储路径没有任何映射关系，靠手动拼接/截断的老方法已经完全失效。
• 不要自己写原生通道去对接ContentResolver，不同安卓版本的权限规则差异很大，用成熟的插件封装的逻辑可以避免绝大多数适配问题。

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