Flutter使用url_launcher在iOS上邮件分享功能失效问题排查

1. 空收件人触发iOS解析异常 #

你的代码中email变量为空字符串，编码后生成的Uri格式为mailto:?subject=xxx&body=xxx。iOS的mailto协议对空收件人的处理逻辑和Android存在差异，部分场景下会直接无响应。

解决办法：
要么设置一个默认收件人（比如占位邮箱），要么调整Uri的构造逻辑，避免空收件人导致的解析问题：

// 方式1：设置默认收件人
String email = Uri.encodeComponent("contact@example.com");

// 方式2：根据收件人是否为空动态构造Uri
Uri mail = email.isEmpty 
    ? Uri.parse("mailto:?subject=$subject&body=$body") 
    : Uri.parse("mailto:$email?subject=$subject&body=$body");

2. iOS未配置URL Scheme查询权限 #

iOS要求在Info.plist中声明允许查询的URL Scheme，否则launchUrl会静默失败，不会抛出任何异常。

解决办法：
在ios/Runner/Info.plist中添加以下配置：

<key>LSApplicationQueriesSchemes</key>
<array>
  <string>mailto</string>
</array>

3. launchUrl缺少iOS适配参数 #

url_launcher的launchUrl方法在iOS上需要指定合适的启动模式，默认模式可能无法适配邮件应用的调用场景。

解决办法：
调用launchUrl时添加mode: LaunchMode.externalApplication，强制唤起外部邮件应用：

await launchUrl(
  mail,
  mode: LaunchMode.externalApplication,
);

4. iOS设备未安装邮件客户端 #

如果用户的iOS设备上没有任何邮件应用（比如原生邮件、Outlook等），mailto协议没有对应的处理程序，就会无响应。

解决办法：
调用前先检查Uri是否可被打开，提前提示用户安装邮件应用：

if (await canLaunchUrl(mail)) {
  await launchUrl(mail, mode: LaunchMode.externalApplication);
} else {
  ToastUtil.show(
    ToastDecorator(
      isSuccess: false,
      msg: "请先安装邮件应用".tr(),
    ),
    context,
    gravity: ToastGravity.bottom,
  );
}

5. 手动拼接Uri导致编码错误 #

虽然你使用了Uri.encodeComponent，但手动拼接Uri时仍可能因特殊字符处理不当，导致iOS解析失败。推荐使用Uri的构造器自动处理编码。

解决办法：
用Uri的构造器生成邮件链接，避免手动拼接的编码问题：

Uri mail = Uri(
  scheme: 'mailto',
  path: email,
  queryParameters: {
    'subject': "${"mpo_product".tr()} - $productTitle($productId)",
    'body': "",
  },
);

内容的提问来源于stack exchange，提问作者Jaimin Modi