Gmail内置浏览器下Android Deep Links重定向无法唤起App的解决方案

Gmail内置浏览器基于安全策略做了App Link拦截限制：仅用户在邮件内直接点击的初始链接会触发App Link域名匹配校验，服务端返回的3xx重定向链路中的目标地址，不会被内置WebView识别为可唤起App的合法App Link地址，该问题是Gmail客户端的固有逻辑，和自身App Link配置正确性无关。

• 调整邮件验证链接域名（兼容性最优）
  将邮件内发送的验证链接从api域名调整为已托管App Link的app域名，例如改为https://app.myapp.com/verify-email/token/asd123。前端部署在app域名下的路由逻辑拿到路径中的token后，异步请求api域名的校验接口完成验证：
  • 若环境触发App Link唤起App，直接将token传递给原生层完成验证状态同步
  • 若在普通浏览器/PWA环境打开，直接渲染邮箱验证成功页面即可
    该方案下用户点击的初始链接就属于App Link绑定域名，Gmail内置WebView会正常触发App匹配逻辑，不会被重定向规则拦截，只需确保app域名下的.well-known/assetlinks.json配置覆盖该验证路径即可。
• 增加中间引导落地页（改造量最小）
  保留原有api域名作为验证链接域名，后端校验token通过后不再直接返回3xx重定向响应，而是在api域名下返回一个轻量中间页：
  • 页面加载后延迟1-2秒主动尝试触发app域名验证页的跳转，同时设置3秒超时阈值，超时未唤起App则自动跳转到PWA的验证成功页
  • 页面上保留明确的主动点击按钮：「打开App完成验证」，按钮直接绑定app域名的验证完成地址。用户主动点击触发的页面跳转可以被Gmail内置WebView识别为合法App Link触发源，可以正常唤起App，同时给未安装App的用户提供「前往网页版」的跳转入口，不阻塞流程。
• UA识别适配
  后端收到验证链接请求时先解析UA标识，匹配到Gmail内置WebView特征（UA包含Gmail、Android WebView相关字段）时，不返回3xx重定向，直接返回带JS跳转逻辑的页面：优先尝试唤起App自定义scheme，失败则跳转PWA验证页；非Gmail WebView环境仍走原有3xx重定向逻辑，减少对普通用户的流程影响。

不要尝试通过修改重定向响应头、叠加多层3xx跳转的方式绕过限制，Gmail内置WebView的拦截逻辑在客户端层实现，服务端配置调整无法绕过，必须满足「初始链接命中App Link域名」或「跳转由用户主动点击触发」两个条件之一，才能正常唤起App。

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