Flutter Web部署Firebase后url_launcher跳转行为异常求助

核心问题分析 #

你遇到的跳转异常，本质是Uri构造方式错误导致生成了相对路径，而非绝对URL。本地调试时环境特性兼容了错误构造，但部署到Firebase后，路由规则或base href的差异暴露了问题。

修复方案 #

替换错误的Uri构造逻辑，改用正确的方式解析或构造绝对URL：

dynamic _launchURL() async {
  Uri parsedUrl;
  // 处理带scheme的完整URL
  if (url.startsWith('http://') || url.startsWith('https://')) {
    parsedUrl = Uri.parse(url);
  } else {
    // 处理不带scheme的域名（自动补https）
    parsedUrl = Uri(scheme: 'https', host: url);
  }

  if (await canLaunchUrl(parsedUrl)) {
    await launchUrl(
      parsedUrl,
      webOnlyWindowName: "_blank",
    );
  } else {
    throw 'Could not launch $url';
    // TODO: open window to copy url
  }
}

原代码错误原因 #

你之前用Uri(path: url, scheme: 'https')的构造方式，会把传入的url当作域名后的路径部分，而非完整的域名或URL。这种逻辑不严谨，在本地调试时可能因浏览器的路径兼容机制正常工作，但部署到Firebase后，会被解析为相对路径，导致目标URL被追加到主页面域名后。

排查方法（针对Firebase部署场景） #

• 浏览器控制台日志：打开浏览器开发者工具（F12）→ 切换到Console标签，点击链接时查看是否有报错信息，比如canLaunchUrl返回false的原因，或url_launcher的异常提示。
• Firebase Hosting日志：登录Firebase控制台→进入目标项目→点击Hosting→切换到「日志」标签，可查看部署后的所有请求日志，排查跳转相关的错误请求。
• 本地预发布测试：执行flutter run --release在本地模拟生产环境，若能复现问题，说明是代码逻辑问题，而非部署环境导致。
• 验证生成的URL：在_launchURL方法中添加print(parsedUrl.toString());，部署后在浏览器控制台查看生成的URL是否为正确的绝对路径（如https://example.com）。

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