Flutter中点击图片跳转网页出现“Could not launch link”错误求助

我想在Flutter中实现点击图片跳转网页的功能，具体实现如下：

使用Link组件传递跳转逻辑：

Link(
  target: LinkTarget.blank,
  uri: Uri.parse('https://en.mentornity.com/corporate-mentoring-software'),
  builder: (context, followLink) => DetailsCard(
    onTap: followLink,
    color: violet,
    title: 'Şirket İçi\nMentorluk',
    networkImage: 'https://en.mentornity.com/assets/img/64f829097a59b73fd8b31dc3f5509a3f.jpg',
  ),
),

自定义DetailsCard组件整合了视觉元素、标题及点击事件，组件代码如下：

// 组件参数定义
final Function()? onTap;
final String networkImage;
final String title;
final TextStyle detailsCard;

// 组件布局
Stack(
  fit: StackFit.expand,
  children: [
    GestureDetector(
      onTap: onTap,
      child: Image.network(
        networkImage,
        fit: BoxFit.fitHeight,
        opacity: const AlwaysStoppedAnimation(.35),
      ),
    ),
    Center(
      child: Text(
        title,
        style: detailsCard,
      ),
    ),
  ],
),

已配置安卓网络权限：

<uses-permission android:name="android.permission.INTERNET" />
<application
    android:usesCleartextTraffic="true"
    <!-- 其他配置项 -->
</application>

但运行时触发点击后出现Could not launch link错误，使用的依赖包为url_launcher。

解决方法 #

1. 补全url_launcher平台配置 #

Android 11及以上版本需要额外配置外部应用查询权限，否则无法唤起浏览器：
在AndroidManifest.xml中添加：

<queries>
    <intent>
        <action android:name="android.intent.action.VIEW" />
        <data android:scheme="https" />
    </intent>
</queries>

如果涉及iOS平台，需要在Info.plist中添加：

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>https</string>
</array>

2. 替换Link组件，直接调用url_launcherAPI #

Link组件的上下文传递可能存在兼容性问题，直接使用launchUrl更稳定：
修改父组件的点击逻辑：

DetailsCard(
  onTap: () async {
    final uri = Uri.parse('https://en.mentornity.com/corporate-mentoring-software');
    if (await canLaunchUrl(uri)) {
      await launchUrl(uri, mode: LaunchMode.externalApplication);
    } else {
      debugPrint('无法打开链接：$uri');
    }
  },
  // 其他参数保持不变
)

注意导入url_launcher包，并确保方法为异步（async/await）。

3. 检查点击区域是否被遮挡 #

Stack中的Text组件可能覆盖了图片的点击区域，导致GestureDetector无法响应。可以给Text添加点击穿透属性：

Center(
  child: Text(
    title,
    style: detailsCard,
    behavior: HitTestBehavior.translucent, // 允许点击穿透到下层组件
  ),
)

4. 验证链接有效性 #

确认目标URL格式正确，且能在设备自带浏览器中正常打开，排除链接本身的问题。

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