React Native安卓应用自定义协议深度链接邮件跳转失效问题

我之前也碰到过一模一样的情况——adb命令测试完全顺畅，iOS邮件里的链接一点就跳，但安卓邮件里的自定义协议链接就像普通文本一样毫无反应，下面几个排查和解决方向应该能帮到你：

1. 补全AndroidManifest.xml的Intent Filter关键配置 #

adb能成功唤起应用说明基础配置没问题，但邮件这类应用需要额外的BROWSABLE类别才能识别你的自定义协议链接。检查你的主Activity配置，确保intent filter包含以下内容：

<activity
  android:name=".MainActivity"
  android:launchMode="singleTask"> <!-- 推荐设置，避免重复启动应用实例 -->
  <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="myapp"
      android:host="open"
      android:pathPattern="/.*" /> <!-- 适配所有子路径，比如/users/123 -->
  </intent-filter>
</activity>

重点是android.intent.category.BROWSABLE，没有它的话，邮件应用会把myapp://开头的链接当成纯文本，不会触发唤起应用的流程。

2. 适配安卓邮件应用的链接处理逻辑 #

有些安卓邮件应用（比如Gmail）对自定义协议链接的处理比较保守：

• 试试长按链接，看是否弹出「在其他应用中打开」或「使用...打开」的选项，手动选择你的应用
• 检查邮件原始内容，确认链接没有被邮件编辑器误转成http/https格式（部分编辑器会自动修改非标准协议链接）

3. 交叉测试不同邮件应用 #

如果只有某一款邮件应用无法识别，大概率是该应用的限制：

• 切换到系统自带邮件、Outlook等应用测试，看是否能正常唤起
• 部分第三方邮件应用会过滤非http/https协议的链接，这种情况可以考虑改用**App Links（通用链接）**替代自定义协议，不过这需要域名配置和SSL证书支持，步骤会更复杂

4. 确认React Native的链接监听逻辑正常 #

虽然adb测试没问题，还是可以快速验证RN代码是否正确监听链接：

import { Linking } from 'react-native';
import { useEffect } from 'react';

useEffect(() => {
  const handleDeepLink = (event) => {
    const url = event.url;
    // 这里处理你的链接跳转逻辑，比如导航到用户详情页
    console.log('收到深度链接:', url);
  };

  // 监听应用运行中的链接
  Linking.addEventListener('url', handleDeepLink);

  // 检查应用冷启动时的初始链接
  Linking.getInitialURL().then(url => {
    if (url) handleDeepLink({ url });
  });

  return () => {
    Linking.removeEventListener('url', handleDeepLink);
  };
}, []);

最后小提醒 #

如果以上都排查过还是不行，试试清理应用缓存、重启设备，或者重新打包APK——有时候安卓系统的Intent缓存会导致新配置不生效。

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