React Native中Deep Link在部分浏览器无法触发问题排查

问题描述 #

我正在给React Native应用添加Deep Link（自定义协议）和Universal Link（HTTPS链接），在App组件中通过以下代码监听URL：

function App() {
  useEffect(() => {
    // ...其他逻辑

    Linking.getInitialURL()
      .then(ev => {
        if (ev) {
          handleOpenURL(ev);
        }
      })
      .catch(err => {
        console.warn('An error occurred', err);
      });

    const subscription = Linking.addEventListener('url', handleOpenURL);

    return () => {
      // ...其他清理逻辑
      subscription.remove();
    };
  }, []);

  return (
    <NavigationContainer
      linking={{
        prefixes: ['onedollardeal://', 'https://onedollardeal.pk'],
      }}
      // ...其他配置
    >
      {/* 导航内容 */}
    </NavigationContainer>
  );
}

目前遇到的问题：

• Google Chrome中，两种链接都无法触发唤起App
• DuckDuckGo浏览器可以正常识别并唤起App
• 使用adb命令测试链接时，能正常触发App唤起

我的Android Manifest配置如下：

<manifest ...>
    <uses-permission android:name="android.permission.INTERNET"/>

    <application
            android:name=".MainApplication"
            android:label="@string/app_name"
            android:icon="@mipmap/ic_launcher"
            android:roundIcon="@mipmap/ic_launcher"
            android:allowBackup="false"
            android:theme="@style/AppTheme">
        <activity
                android:name=".MainActivity"
                android:label="@string/app_name"
                android:configChanges="keyboard|keyboardHidden|orientation|screenSize|uiMode"
                android:launchMode="singleTask"
                android:windowSoftInputMode="adjustResize">
            <intent-filter android:autoVerify="true">
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                <data android:scheme="https"
                    android:host="onedollardeal.pk" />
            </intent-filter>
            <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="onedollardeal" />
                <data android:scheme="https" android:host="onedollardeal.pk" />
                <data android:scheme="http" android:host="onedollardeal.pk" />
            </intent-filter>
            <intent-filter android:label="filter_react_native">
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                <data android:scheme="onedollardeal" />
            </intent-filter>
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>
        ....
</manifest>

补充疑问：DuckDuckGo能识别但Chrome不行，这和默认浏览器设置有关吗？

问题原因及解决方案 #

核心问题：重复的Intent Filter配置冲突 #

你的Manifest里存在多个重复的Intent Filter，尤其是针对https://onedollardeal.pk和onedollardeal://的配置重复出现，这会导致Chrome（对Intent匹配逻辑更严格）无法正确识别唤起规则，而DuckDuckGo的匹配逻辑更宽松，所以能正常工作。

另外，Universal Link的android:autoVerify="true"配置必须单独放在一个Intent Filter中，不能和其他Scheme（比如自定义协议、http）混合，否则会导致验证失败。

修正后的Manifest配置 #

把重复的Intent Filter合并，确保Universal Link和Deep Link的配置分离：

<manifest ...>
    <uses-permission android:name="android.permission.INTERNET"/>

    <application
            android:name=".MainApplication"
            android:label="@string/app_name"
            android:icon="@mipmap/ic_launcher"
            android:roundIcon="@mipmap/ic_launcher"
            android:allowBackup="false"
            android:theme="@style/AppTheme">
        <activity
                android:name=".MainActivity"
                android:label="@string/app_name"
                android:configChanges="keyboard|keyboardHidden|orientation|screenSize|uiMode"
                android:launchMode="singleTask"
                android:windowSoftInputMode="adjustResize">
            <!-- Universal Link 专用配置，必须单独设置autoVerify=true -->
            <intent-filter android:autoVerify="true">
                <action android:name="android.intent.action.VIEW" />
                <category android:name="android.intent.category.DEFAULT" />
                <category android:name="android.intent.category.BROWSABLE" />
                <data android:scheme="https" android:host="onedollardeal.pk" />
            </intent-filter>

            <!-- Deep Link 配置：处理自定义协议和http链接 -->
            <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="onedollardeal" />
                <!-- http协议的链接（如果需要支持） -->
                <data android:scheme="http" android:host="onedollardeal.pk" />
            </intent-filter>

            <!-- 应用启动入口 -->
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
        </activity>
        ....
</manifest>

额外检查点 #

1. Universal Link验证文件：确保你的域名onedollardeal.pk的.well-known目录下存在assetlinks.json文件，且内容正确（包含你的应用的包名和签名指纹）。Chrome需要验证这个文件才能启用Universal Link唤起。
2. 清除缓存：修改配置后，清除应用的缓存和Chrome的缓存，避免旧配置残留影响测试。
3. Chrome设置检查：在Chrome中打开目标链接时，如果没有弹出"打开应用"的提示，大概率是autoVerify验证失败，需要检查assetlinks.json的有效性。
4. 默认浏览器的影响：如果Chrome是默认浏览器，确实会影响链接的处理逻辑，但核心问题还是Intent Filter的配置冲突，修正配置后即可解决。

内容的提问来源于stack exchange，提问作者Ali Yar Khan