Flutter调用WhatsappShare.shareFile触发PlatformException错误求助

核心原因排查 #

这个异常通常由以下问题引发：

• 设备未安装目标WhatsApp应用（普通版包名com.whatsapp，商业版为com.whatsapp.w4b）
• 待分享文件不存在、路径错误或应用无读取权限
• 分享Intent参数不符合WhatsApp要求，比如错误使用SEND_MULTIPLE、MIME类型设置为*/*
• Flutter调用分享时的上下文未关联当前Activity

分步解决 #

1. 先验证WhatsApp安装状态 #

调用分享前先检查目标应用是否存在，避免无效调用：

import 'package:url_launcher/url_launcher.dart';

Future<bool> checkWhatsAppInstalled(String packageName) async {
  final url = Uri.parse('market://details?id=$packageName');
  return await canLaunchUrl(url);
}

// 使用示例
final isInstalled = await checkWhatsAppInstalled('com.whatsapp');
if (!isInstalled) {
  // 提示用户安装WhatsApp
  return;
}

若使用商业版，将包名替换为com.whatsapp.w4b即可。

2. 确保文件可正常访问 #

保存网络图片后，先验证文件存在性，且存储在应用有权限访问的目录：

import 'package:path_provider/path_provider.dart';
import 'dart:io';

// 优先使用应用私有临时目录，无需额外权限
final tempDir = await getTemporaryDirectory();
final imagePath = '${tempDir.path}/shared_img.jpg';

// 保存完成后验证文件
final imageFile = File(imagePath);
if (!await imageFile.exists()) {
  // 处理文件保存失败的情况
  return;
}

Android 10+避免使用外部公共目录，否则易触发权限问题。

3. 调整ShareFile调用参数 #

单个文件分享时不要触发SEND_MULTIPLE逻辑，明确指定文件类型而非*/*：

await WhatsappShare.shareFile(
  phone: '+8613xxxxxxxxx', // 必须携带国家码
  filePath: [imagePath], // 单个文件也传列表，但确保仅含一个元素
  fileType: FileType.image, // 明确指定类型，提升兼容性
  text: '附带的分享文案',
);

若需分享多个文件，需确保所有文件均存在且类型统一。

4. 配置AndroidManifest权限 #

Android 11+需在AndroidManifest.xml中添加应用查询权限，否则系统会限制Intent调用：

<manifest ...>
  <queries>
    <package android:name="com.whatsapp" />
    <package android:name="com.whatsapp.w4b" />
  </queries>
  ...
</manifest>

5. 检查分享包版本 #

确保你使用的WhatsApp分享包（如flutter_whatsapp_share）为最新版本，旧版本可能存在上下文绑定bug，导致找不到Activity。

测试验证 #

按上述步骤调整后，重新验证以下内容：

• 目标WhatsApp应用已安装
• 图片成功保存到指定路径
• 分享参数中的手机号、文件路径、类型均正确

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