Flutter Web中url_launcher#launchUrl()在Chrome/Edge返回false问题

问题现象 #

在Chrome和Edge浏览器的调试、生产环境下，点击AppBar上的代码IconButton调用launchUrl()打开外部链接：

• 新标签页能正常打开目标链接
• 控制台却抛出Exception("Could not launch https://gitlab.com/friend.code")，说明launchUrl()返回了false，触发了失败判定逻辑

代码实现 #

调用launchUrl()的方法：

Future<void> _launchUrl(String urlString) async {
  if (!await launchUrl(Uri.parse(urlString))) {
    throw Exception("Could not launch $urlString");
  }
}

AppBar中的调用逻辑：

appBar: AppBar(
  backgroundColor: Theme.of(context).colorScheme.primaryContainer,
  title: Text(widget.title),
  actions: [
    IconButton(onPressed: () => setState(() {
      _launchUrl("https://gitlab.com/friend.code");
    }), icon: const Icon(Icons.code)),
    IconButton(onPressed: () {}, icon: const Icon(Icons.person)),
    IconButton(onPressed: () {}, icon: const Icon(Icons.music_note))
  ],
),

调试与测试细节 #

• 跟踪到url_launcher_web插件内部的openNewWindow()方法，其中调用的_window.open(url, target, 'noopener, noreferrer')返回了null，插件据此判定启动失败，返回false
• 测试webOnlyWindowName参数：
  • 设置为"_self"：链接在当前标签页打开，无错误，launchUrl()返回true
  • 设置为"_blank"：新标签页正常打开，但插件仍返回false并触发异常

原因分析 #

这是浏览器安全机制与插件判定逻辑的冲突：
当使用noopener, noreferrer参数打开新窗口时，浏览器会切断新窗口与父窗口的关联，导致window.open()无法返回新窗口的引用（返回null）。而url_launcher_web插件仅通过window.open()的返回值判断是否成功，因此出现实际窗口已打开，但插件误判为失败的情况。

临时解决方案 #

方案1：忽略Web环境下的返回值，捕获异常 #

修改_launchUrl()方法，针对Web环境跳过失败判定，或仅打印警告而非抛出异常：

Future<void> _launchUrl(String urlString) async {
  try {
    await launchUrl(
      Uri.parse(urlString),
      webOnlyWindowName: "_blank",
    );
  } catch (e) {
    // 仅打印警告，因为多数情况是误判
    debugPrint("Launch URL warning: $e");
  }
}

方案2：Web平台直接调用原生API #

通过条件编译，在Web环境下直接调用dart:html的window.open()，绕开插件的判定逻辑：

import 'dart:html' as html;
import 'package:flutter/foundation.dart';

Future<void> _launchUrl(String urlString) async {
  final uri = Uri.parse(urlString);
  if (kIsWeb) {
    html.window.open(uri.toString(), "_blank", "noopener, noreferrer");
  } else {
    if (!await launchUrl(uri)) {
      throw Exception("Could not launch $urlString");
    }
  }
}

内容的提问来源于stack exchange，提问作者friend.code