Android WebView点击外部链接唤起关联应用报页面找不到解决方法

问题原因 #

Android WebView默认不会主动将加载的URL交给系统路由处理，所有链接请求都会尝试在当前WebView组件内渲染。当链接是第三方应用注册的唤起链接（包含自定义scheme链接、App Link/Universal Link）时，WebView本身没有对应页面的渲染能力，就会抛出页面找不到的错误，无法触发目标应用唤起逻辑。

核心实现逻辑 #

通过重写WebViewClient的shouldOverrideUrlLoading方法，在URL加载前做路由分流：自有站点链接交给WebView正常加载，外部链接优先交给系统匹配可处理的关联应用，匹配成功则直接唤起，失败再走兜底逻辑。

完整代码实现 #

// 初始化WebView时配置自定义WebViewClient
webView.setWebViewClient(new WebViewClient() {
    // API 24及以上版本走该回调
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        String loadUrl = request.getUrl().toString();
        // 替换为你自有站点的域名规则，符合规则的链接在WebView内加载
        if (isSelfSiteUrl(loadUrl)) {
            return false;
        }
        // 尝试唤起系统内匹配的关联应用
        try {
            Intent appIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(loadUrl));
            appIntent.addCategory(Intent.CATEGORY_BROWSABLE);
            // 校验是否存在可处理该链接的应用
            if (appIntent.resolveActivity(getPackageManager()) != null) {
                startActivity(appIntent);
                return true;
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        // 兜底逻辑：无匹配应用时可选择用系统浏览器打开，或弹出提示
        try {
            Intent browserIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(loadUrl));
            startActivity(browserIntent);
        } catch (Exception e) {
            Toast.makeText(YourActivity.this, "当前无应用可打开该链接", Toast.LENGTH_SHORT).show();
        }
        return true;
    }

    // API 23及以下版本兼容回调
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        if (isSelfSiteUrl(url)) {
            return false;
        }
        try {
            Intent appIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
            appIntent.addCategory(Intent.CATEGORY_BROWSABLE);
            if (appIntent.resolveActivity(getPackageManager()) != null) {
                startActivity(appIntent);
                return true;
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
        try {
            Intent browserIntent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
            startActivity(browserIntent);
        } catch (Exception e) {
            Toast.makeText(YourActivity.this, "当前无应用可打开该链接", Toast.LENGTH_SHORT).show();
        }
        return true;
    }

    // 自行实现自有站点的链接判断逻辑
    private boolean isSelfSiteUrl(String url) {
        return url.contains("your-official-domain.com");
    }
});

适配注意事项 #

• Android 11（API 30）及以上系统引入了包可见性限制，必须在AndroidManifest.xml中添加查询权限配置，否则无法检测到第三方应用的链接处理能力，配置示例：

<manifest ...>
    <!-- 应用其他基础配置 -->
    <queries>
        <!-- 支持http/https协议的App Link匹配 -->
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="https" />
        </intent>
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="http" />
        </intent>
        <!-- 按需添加需要支持的自定义scheme，比如Instagram的instagram://协议 -->
        <intent>
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data android:scheme="instagram" />
        </intent>
    </queries>
</manifest>

• 不要无差别拦截所有URL返回true，会导致自有站点的页面跳转逻辑失效
• 唤起第三方应用的Intent必须添加CATEGORY_BROWSABLE分类，否则无法匹配到浏览器、第三方社交类应用注册的链接路由规则
• 调用startActivity前必须做存在性校验和异常捕获，避免链接无对应处理应用时触发崩溃
• 自有域名判断逻辑请根据自身业务的实际路由规则调整，不要硬编码后缀匹配避免误判

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