Flutter使用uni_links捕获HTTPS App Link失败，如何解决？

首先，你的代码存在一个直接的逻辑错误，导致初始URL无法被捕获：

在initURIHandler方法中，你错误地判断了initialURI != null，但此时initialURI的初始值为null，正确的判断对象应该是你刚获取到的initialURITemp。修正后的该方法代码如下：

Future<void> initURIHandler() async {
  if (!initialURILinkHandled) {
    initialURILinkHandled = true;
    try {
      final initialURITemp = await getInitialUri();
      // 修正判断条件，检查实际获取到的URI临时变量
      if (initialURITemp != null) {
        debugPrint("Initial URI received $initialURITemp");
        if (!mounted) {
          return;
        }
        setState(() {
          initialURI = initialURITemp;
        });
      } else {
        debugPrint("Null Initial URI received");
      }
    } on PlatformException {
      debugPrint("Failed to receive initial uri");
    } on FormatException catch (error) {
      if (!mounted) {
        return;
      }
      debugPrint('Malformed Initial URI received');
      setState(() => err = error);
    }
  }
}

除此之外，还需要检查以下几个关键点：

• 确认AndroidManifest.xml中的<intent-filter>配置在**启动Activity（通常是MainActivity）**的标签内部，若放错位置，App虽能被唤起但无法接收URL参数。
• 确保你使用的链接处理插件（如uni_links或app_links）已正确安装依赖，Android端无配置遗漏（新版本插件一般无需额外代码，但旧版本可能需要在MainActivity中手动处理Intent）。
• 分场景测试：
  • 冷启动：完全关闭App后，从外部应用（浏览器、短信等）点击目标URL打开App，此时getInitialUri应能捕获到初始URL。
  • 热启动：App在后台运行时点击链接唤起，此时uriLinkStream会推送URL，你的incomingLinkHandler方法应能接收并处理。
• 验证android:autoVerify="true"的配置：需在网站根目录的.well-known文件夹下放置assetlinks.json，包含App包名和签名指纹。若验证失败，部分设备可能无法正常传递URL（你已看到选择App的提示，这一步大概率没问题，但仍建议确认）。

成功捕获URL后，即可根据路径或参数导航到对应路由，示例代码：

// 示例：处理https://www.mywebsite.com/product?id=123这类链接
if (initialURI != null) {
  final path = initialURI!.path;
  if (path == '/product') {
    final productId = initialURI!.queryParameters['id'];
    Navigator.pushNamed(context, '/product', arguments: productId);
  }
}

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