Flutter Web使用URL Launcher向WhatsApp联系人发送PDF文件的实现问题

核心结论 #

首先你目前使用的wa.me链接是WhatsApp官方提供的快捷跳转协议，本身仅支持传递文本参数，不支持直接携带文件，因此不需要将PDF转成Uri再塞到链接参数里，这种方式即使强行实现也会因为参数长度超限、WhatsApp侧不识别等问题无法生效。

两种可选实现方案 #

方案1：公网链接传递（兼容性最高、实现最简单） #

这是目前最通用的实现方式，步骤如下：

• 先将你要发送的PDF上传到公网可访问的存储节点（比如自有服务器静态资源目录、云对象存储服务），获取PDF的可公开访问的直链
• 将该直链拼接进发送文本中，编码后传入wa.me的text参数即可，用户跳转到WhatsApp窗口后可直接点击链接下载/预览PDF

修改后的示例代码：

import 'package:url_launcher/url_launcher.dart';

void _openWhatsApp(String phoneNumberControllerText, String pdfPublicUrl) async {
  String phoneNumber = phoneNumberControllerText;
  // 对发送文本做Uri编码，避免特殊字符、空格等导致链接失效
  final String sendContent = Uri.encodeComponent('您需要的PDF文件请点击链接获取：$pdfPublicUrl');
  final Uri whatsappUrl = Uri.parse('https://wa.me/$phoneNumber?text=$sendContent');
  // 新版url_launcher推荐使用launchUrl方法替代已废弃的launch方法
  await launchUrl(whatsappUrl);
}

方案2：本地PDF直接作为附件分享（仅支持现代浏览器） #

如果需要直接发送本地生成的PDF作为附件，不需要提前上传，可以调用Web端的Web Share API实现，该方案有浏览器兼容性限制，仅支持Chrome 89+、Edge 89+、Safari 15+以上版本的现代浏览器，实现代码示例：

import 'dart:html' as html;
import 'package:url_launcher/url_launcher.dart';

void sharePdfToWhatsApp(String phoneNumber, List<int> pdfBytes, String pdfFileName) async {
  try {
    // 将PDF字节流转为浏览器可识别的File对象
    final pdfBlob = html.Blob([pdfBytes], 'application/pdf');
    final pdfFile = html.File([pdfBlob], pdfFileName, {'type': 'application/pdf'});

    // 检查当前浏览器是否支持带文件的分享能力
    if (html.window.navigator.share != null && html.window.navigator.canShare != null) {
      final sharePayload = {
        'title': 'PDF文件分享',
        'text': '这是您需要的PDF文件',
        'files': [pdfFile],
      };
      if (html.window.navigator.canShare(sharePayload)) {
        await html.window.navigator.share(sharePayload);
        return;
      }
    }

    // 兼容性降级：如果浏览器不支持分享API，自动切换为方案1的链接分享
    final String sendContent = Uri.encodeComponent('您需要的PDF文件请点击链接获取：$你的PDF公网链接');
    final Uri fallbackUrl = Uri.parse('https://wa.me/$phoneNumber?text=$sendContent');
    await launchUrl(fallbackUrl);
  } catch (e) {
    print('分享失败：$e');
  }
}

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