Android应用Chrome自定义标签Digital Asset Link偶发验证失败咨询

一、DAL验证底层逻辑与调试方案 #

底层运行逻辑 #

• DAL验证是Chrome为了防止恶意应用伪造请求头，建立的应用与目标域名归属权双向校验机制，完整流程分为三步：
  1. 读取应用AndroidManifest.xml中配置的asset_statements声明，确认应用主动声明了与目标域名的关联关系
  2. 由Chrome进程向目标域名的/.well-known/assetlinks.json路径发起请求，拉取域名侧配置的关联声明，校验文件中是否包含当前应用的包名、签名SHA256指纹的绑定配置
  3. 双向校验通过后，结果会被Chrome全局缓存，默认缓存有效期为72小时，缓存期内重复校验会直接返回本地结果，无需重新拉取校验文件
• 你观测到的发版后3-4天自动恢复的规律，刚好匹配Chrome缓存+CDN缓存的过期时间，故障原因大概率是发版后新的关联配置同步不及时，新旧缓存混杂导致的随机校验失败

调试指引 #

• 开启Chrome内置调试日志：在Chrome地址栏输入chrome://flags/#digital-asset-links-verification-debug，启用调试开关后，执行adb logcat -s "DigitalAssetLinks"即可查看具体的校验失败原因，可直接定位是校验文件拉取失败、签名不匹配还是缓存问题
• 发版前先刷新assetlinks.json的所有CDN节点缓存，避免新旧配置混杂
• 在现有的校验回调中增加重试逻辑，校验失败后间隔2-3秒重新发起校验请求，最多重试2次即可覆盖绝大多数缓存临时不一致的场景，示例代码如下：

CustomTabsCallback callback = new CustomTabsCallback() {
    // 最大重试次数
    private static final int MAX_RETRY_TIMES = 2;
    private int currentRetryCount = 0;
    @Override
    public void onRelationshipValidationResult(int relation, @NonNull Uri requestedOrigin, 
        boolean result, @Nullable Bundle extras) {
        // 校验失败且未到最大重试次数时，重新发起校验
        if (!result && currentRetryCount < MAX_RETRY_TIMES) {
            currentRetryCount++;
            mSession.validateRelationship(CustomTabsService.RELATION_USE_AS_ORIGIN, requestedOrigin, null);
            return;
        }
        // 校验通过或重试次数耗尽后再发起跳转
        CustomTabsIntent intent = constructExtraHeadersIntent(mSession);
        intent.launchUrl(MainActivity.this, Uri.parse(url));
    }
};

二、无需WebView的替代方案 #

• 预校验方案：在应用启动、用户尚未触发打开自定义标签的操作时，就提前调用CustomTabsSession#validateRelationship接口预先完成校验，将通过的结果提前缓存到Chrome本地，用户操作时直接调用已完成校验的会话发起跳转，完全规避实时校验失败的问题
• 服务端中转方案：由你的服务端作为代理，携带要求的请求头向第三方拉取HTML内容，再将内容返回给自定义标签加载，该方案完全不需要依赖DAL验证，不存在校验失败的问题
• 浏览器兜底方案：如果多次校验依然失败，可以弹窗提示用户跳转系统浏览器加载，部分主流浏览器也支持自定义请求头的跳转配置，兼容性可以覆盖绝大多数用户

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