React Native Deep Link问题：点击验证邮件首次返回自定义Scheme而非预期URL

问题描述 #

点击验证邮件中的链接时，首次触发Deep Link未返回预期的https://mydom.com/EmailVerified?token=1234，而是得到自定义URL Scheme：com.rithmm.mobile://expo-development-client/?url=http%3A%2F%2F192.168.1.3%3A8081，重复操作才能获得预期结果。

当前Linking配置如下：

// 实际返回结果
//  com.rithmm.mobile://expo-development-client/?    url=http%3A%2F%2F192.168.1.3%3A8081

// 预期结果
//  https://mydom.com/EmailVerified?token=1234
const linking: LinkingOptions<RootStackParamList> = {
  prefixes: [
    // https, including subdomains like www.
    `https://${url}/`,
    `https://*.${url}/`,
    // http, including subdomains like www.
    `http://${url}/`,
    `http://*.${url}/`,
    Linking.createURL('/')
  ],
};

原因分析 #

1. Linking.createURL('/')在Expo开发环境下会生成指向开发客户端的Scheme链接（如com.rithmm.mobile://expo-development-client/...），该前缀会与HTTPS前缀共同参与匹配。首次打开时，开发客户端可能优先捕获这个Scheme，导致返回非预期链接。
2. 重复操作后应用处于活跃状态，系统会优先匹配已注册的HTTPS前缀，因此返回预期结果。

解决方案 #

1. 区分环境配置前缀 #

仅在开发环境添加Linking.createURL('/')，生产环境移除该前缀，避免开发相关Scheme干扰：

const isDevelopment = process.env.NODE_ENV === 'development';

const linking: LinkingOptions<RootStackParamList> = {
  prefixes: [
    `https://${url}/`,
    `https://*.${url}/`,
    `http://${url}/`,
    `http://*.${url}/`,
    // 仅开发环境添加开发客户端前缀
    ...(isDevelopment ? [Linking.createURL('/')] : [])
  ],
};

2. 强制匹配HTTPS前缀（可选） #

若需在开发环境保留开发前缀，可通过getInitialURL手动过滤，确保优先匹配HTTPS链接：

const linking: LinkingOptions<RootStackParamList> = {
  prefixes: [
    `https://${url}/`,
    `https://*.${url}/`,
    `http://${url}/`,
    `http://*.${url}/`,
    Linking.createURL('/')
  ],
  getInitialURL: async () => {
    const initialUrl = await Linking.getInitialURL();
    if (!initialUrl) return null;
    // 优先返回预期的HTTPS/HTTP链接
    if (initialUrl.startsWith(`https://${url}/`) || initialUrl.startsWith(`http://${url}/`)) {
      return initialUrl;
    }
    // 解析开发链接中的实际目标URL
    const urlParams = new URLSearchParams(initialUrl.split('?')[1]);
    const actualUrl = urlParams.get('url');
    return actualUrl || initialUrl;
  },
};

3. 验证邮件链接格式 #

确认发送的验证邮件链接为标准HTTPS格式https://mydom.com/EmailVerified?token=1234，未被错误替换为带自定义Scheme的链接。

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