Flutter使用url_launcher无法打开Google Maps cid链接怎么办

排查思路 #

• 先核对平台配置合规性：url_launcher 6.0及以上版本对外部应用跳转做了权限限制，带cid的maps.google.com链接会被系统优先识别为谷歌地图App的唤起链接，若未配置对应应用查询白名单，会直接抛出无法启动的异常，和短链走通用网页解析的逻辑完全不同。
• 验证链接原生唤起能力：将出问题的https://maps.google.com/?cid=xxx链接复制到测试机自带浏览器打开，若浏览器端也无法正常跳转谷歌地图，说明是当前设备谷歌地图版本对旧cid链接格式兼容性不足，和Flutter代码逻辑无关。
• 检查调用参数正确性：确认launch/launchUrl方法没有误将启动模式设为强制内嵌webview、禁用外部应用跳转，错误的参数配置会导致系统拦截跳转请求。

落地解决方案 #

1. 修正调用配置与平台白名单
   调用打开链接方法时，明确指定使用外部应用模式启动，不要用默认的自适应模式：

   import 'package:url_launcher/url_launcher.dart';
   
   Future<void> openMapLink(String mapUrl) async {
     final Uri targetUri = Uri.parse(mapUrl);
     if (!await launchUrl(
       targetUri,
       // 关键配置：明确走外部应用跳转逻辑
       mode: LaunchMode.externalApplication,
     )) {
       // 打开失败时的降级逻辑
       debugPrint('地图链接打开失败');
     }
   }
   

   Android端需在android/app/src/main/AndroidManifest.xml的<manifest>节点下添加查询白名单，否则系统无法识别谷歌地图App：

   <queries>
       <intent>
           <action android:name="android.intent.action.VIEW" />
           <data android:scheme="https" android:host="maps.google.com" />
       </intent>
       <package android:name="com.google.android.apps.maps" />
   </queries>
   

   iOS端需在ios/Runner/Info.plist中添加应用查询白名单：

   <key>LSApplicationQueriesSchemes</key>
   <array>
       <string>comgooglemaps</string>
   </array>
   

2. 兼容处理cid链接格式
   若配置完成后旧格式cid链接仍无法打开，直接从原链接中提取cid参数，拼接为谷歌地图标准域名下的链接即可，该格式同时兼容App唤起和浏览器打开：

   final originalUri = Uri.parse('https://maps.google.com/?cid=10698500154823482329');
   final cid = originalUri.queryParameters['cid'];
   // 拼接为兼容格式
   final compatibleMapUri = Uri.parse('https://www.google.com/maps?cid=$cid');
   // 调用上述openMapLink方法打开compatibleMapUri即可
   

3. 兜底降级方案
   若检测到链接打开失败，可自动切换为内嵌WebView模式加载，避免直接抛异常：

   // 打开失败时的兜底逻辑
   if (!await launchUrl(targetUri, mode: LaunchMode.externalApplication)) {
     await launchUrl(targetUri, mode: LaunchMode.inAppWebView, enableJavaScript: true);
   }
   

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