Android中HTTP 302跳转至Deep Link功能失效问题排查

我处理过不少类似的Deep Link唤起问题，结合你的场景，Android端302跳转失效大概率是系统限制、配置问题或者跳转方式兼容性导致的，下面给你拆解几个核心原因和对应的解决办法：

1. Android系统对自定义Scheme跳转的安全限制 #

Android 11+的系统和主流浏览器（比如Chrome）对302跳转至自定义Scheme（如myapp://）有严格的安全校验，默认不会自动唤起App，甚至会直接拦截。另外，App的intent-filter配置错误也会导致系统无法匹配到你的应用。

解决步骤： #

• 检查AndroidManifest.xml中的intent-filter配置，确保包含必要的action、category和scheme：

  <activity android:name=".DeepLinkActivity">
      <intent-filter>
          <action android:name="android.intent.action.VIEW" />
          <category android:name="android.intent.category.DEFAULT" />
          <category android:name="android.intent.category.BROWSABLE" />
          <!-- 匹配你的自定义Scheme -->
          <data android:scheme="myapp" />
      </intent-filter>
  </activity>
  

• 如果是在App内的WebView中跳转，需要手动拦截自定义Scheme并唤起：

  webView.setWebViewClient(new WebViewClient() {
      @Override
      public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
          String targetUrl = request.getUrl().toString();
          // 检测是否为自定义Scheme链接
          if (targetUrl.startsWith("myapp://")) {
              Intent deepLinkIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(targetUrl));
              // 先判断是否有应用能处理这个Intent，避免崩溃
              if (deepLinkIntent.resolveActivity(getPackageManager()) != null) {
                  startActivity(deepLinkIntent);
                  return true; // 拦截默认跳转行为
              }
          }
          return super.shouldOverrideUrlLoading(view, request);
      }
  });
  

2. 302响应的Location头编码错误 #

你示例中的Deep Link包含&（HTML实体转义的&），iOS可能会自动解码，但Android的部分浏览器/WebView不会处理这个转义，导致最终的Deep Link格式错误，无法匹配到App的intent-filter。

解决步骤： #

在API服务返回302时，Location头直接使用原始的&符号，比如返回：

myapp://home/?abc=xxx&bcd=yyy

而不是转义后的myapp://home/?abc=xxx&bcd=yyy。

3. 改用HTML+JS跳转替代302 #

很多Android浏览器会拦截302跳转至自定义Scheme的请求，相比之下，用JavaScript主动触发跳转的兼容性要好得多。

解决步骤： #

当API检测到Android客户端时，不要返回302，而是返回一个简单的HTML页面，通过JS主动唤起Deep Link：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>唤起应用</title>
</head>
<body>
    <script>
        // 尝试唤起App
        window.location.href = 'myapp://home/?abc=xxx&bcd=yyy';
        
        // 备用方案：如果2秒内没唤起，引导用户下载或打开应用商店
        setTimeout(() => {
            window.location.href = 'https://your-app-download-url.com';
        }, 2000);
    </script>
</body>
</html>

这种方式能绕过大部分浏览器的拦截，成功率更高。

4. 检查App Links配置冲突 #

如果你的App同时配置了App Links（通过https域名关联应用），可能会和自定义Scheme的唤起逻辑冲突，导致系统优先用浏览器打开链接。

解决步骤： #

• 暂时移除App Links相关的intent-filter和assetlinks.json配置，测试是否能正常唤起。
• 如果需要保留App Links，确保自定义Scheme的intent-filter优先级更高（比如设置android:priority="1000"）。

你可以按照这个顺序逐一排查，先从intent-filter配置和Location头编码入手，这两个是最常见的问题。如果还是不行，换成JS跳转的方式基本能解决大部分Android端的唤起问题。

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