Flutter使用url_launcher抛出PlatformException通道连接异常求助

这个问题在Flutter开发者群体中不少人碰到过，以下是经过验证的解决步骤：

1. 放弃热重载，完全重启App #

热重载无法正确加载原生插件的通道连接，尤其是刚添加或更新插件后。停止当前运行的App，重新执行flutter run启动项目，不要使用热重载/热重启。

2. 清理项目缓存并重新构建 #

执行以下命令清理缓存，重新拉取依赖：

flutter clean
flutter pub get

完成后重新编译运行App。

3. 升级url_launcher到最新稳定版 #

你当前使用的url_launcher: ^6.0.20版本相对较旧，新版本修复了不少通道相关的问题。运行命令升级：

flutter pub upgrade url_launcher

4. 替换为最新的API调用 #

你目前使用的canLaunch和launch是旧版API，在新版本插件中可能存在兼容性问题，建议替换为官方推荐的canLaunchUrl和launchUrl，示例代码如下：

import 'package:url_launcher/url_launcher.dart';

Future<void> sendEmail(String emailAddress, {String subject = '', String body = ''}) async {
  final Uri emailLaunchUri = Uri(
    scheme: 'mailto',
    path: emailAddress,
    queryParameters: {'subject': subject, 'body': body},
  );
  
  log('$emailLaunchUri');
  
  if (await canLaunchUrl(emailLaunchUri)) {
    await launchUrl(emailLaunchUri, mode: LaunchMode.externalApplication);
  } else {
    log('unable to start email');
  }
}

注意：使用queryParameters不需要手动编码，Uri会自动处理参数编码逻辑。

5. 检查Android端配置（针对Android 11+） #

如果你的App运行在Android 11及以上系统，确保AndroidManifest.xml中添加了查询邮件应用的权限配置，避免系统限制插件检测邮件应用：

<queries>
  <intent>
    <action android:name="android.intent.action.SENDTO" />
    <data android:scheme="mailto" />
  </intent>
</queries>

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