Flutter深度链接（uni_links）真机无法正常工作问题求助

看起来你遇到的问题很典型——模拟器上正常工作，真机却拿不到链接数据，我来帮你梳理几个最可能的原因和对应的修复方法：

1. 未处理冷启动的初始链接 #

你的代码只依赖getLinksStream()来监听链接，但在冷启动（应用完全关闭后通过深度链接打开）场景下，这个流可能不会立即返回初始链接，导致StreamBuilder的snapshot一开始没有数据，直接跳转到了HomePage。

模拟器启动速度快，或者你测试的是热启动（应用在后台时打开链接），所以流能及时捕获到数据；但真机冷启动时，应用初始化过程更长，流还没来得及接收数据，builder就已经执行了无数据的分支。

修复方案：结合getInitialLink()和流监听 #

把FutureBuilder和StreamBuilder结合起来，先获取冷启动的初始链接，再监听后续的链接事件：

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        primaryColor: Colors.white,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: FutureBuilder<Uri?>(
        // 获取冷启动时的初始链接
        future: getInitialLink(),
        builder: (context, initialSnapshot) {
          return StreamBuilder<Uri?>(
            stream: getLinksStream(),
            builder: (context, streamSnapshot) {
              // 优先使用流的最新数据，没有的话用初始链接
              Uri? targetUri = streamSnapshot.data ?? initialSnapshot.data;
              
              if (targetUri != null) {
                List<MapEntry<String, List<String>>> params = targetUri.queryParametersAll.entries.toList();
                return urlResponse(targetUri, params);
              } else {
                return HomePage();
              }
            },
          );
        },
      ),
    );
  }
}

2. Android 12+ 缺少exported="true"属性 #

如果你的真机是Android 12（API 31）及以上版本，系统要求接收外部Intent的Activity必须显式设置android:exported="true"，否则会被系统拦截Intent，导致应用无法接收到深度链接。模拟器可能是低版本系统，没有这个限制，所以能正常工作。

修复方案：检查AndroidManifest.xml #

确保你的MainActivity标签里添加了exported="true"：

<activity
    android:name=".MainActivity"
    android:exported="true"> <!-- 必须添加这个属性 -->
    <!-- Deep Links -->
    <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="http" android:host="example.com" android:pathPrefix="/myApp"/>
    </intent-filter>
</activity>

3. 系统默认应用抢占了链接 #

你使用的是http scheme，真机上的浏览器或其他应用可能已经注册了相同的http://example.com链接，导致系统优先打开其他应用，而不是你的Flutter应用。模拟器上可能没有这类抢占的应用，所以正常。

修复方案：使用自定义Scheme #

改用自定义的scheme（比如myapp://），避免和系统应用冲突：

修改AndroidManifest.xml的data标签：

<data android:scheme="myapp" android:host="example.com" android:pathPrefix="/myApp"/>

测试时使用链接：myapp://example.com/myApp?param=1，这样系统会直接匹配你的应用。

4. 应用签名或安装包问题 #

如果你的真机安装的是正式签名的APK，而模拟器用的是调试签名，可能存在配置不一致的情况；或者真机上的应用没有更新到最新版本，旧版本的配置有问题。

排查步骤： #

• 卸载真机上的旧应用，重新安装最新的调试/正式包
• 确保调试和正式包的配置（比如AndroidManifest）完全一致

最后验证测试 #

用adb命令直接测试真机上的深度链接，确保Intent能正确传递到你的应用：

adb shell am start -W -a android.intent.action.VIEW -d "http://example.com/myApp?test=1" com.your.package.name

替换com.your.package.name为你的应用包名，执行后如果能打开应用并跳转到urlResponse页面，说明配置已经生效。

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