CustomTabsIntent无法设置Cookie 求排查原因及解决方法

问题成因 #

1. Browser.EXTRA_HEADERS 传Cookie的局限性：通过该参数添加的Cookie仅作为单次HTTP请求的临时请求头，不会被Chrome持久化存储到Cookie容器中，因此在DevTools的Application > Cookies中无法查询到。
2. Digital Asset Links 关联未真正生效：即便你确认配置了关联文件，仍可能存在隐性问题——比如JSON格式校验不通过、服务器返回文件时未设置Content-Type: application/json响应头、Google服务器验证缓存未同步，导致Chrome判定该Cookie来自第三方来源触发拦截。
3. Cookie属性缺失：你设置的Cookie仅包含键值对，缺少Domain、Path、SameSite等关键属性，不符合Chrome的Cookie存储规则，无法被识别为有效第一方Cookie。

修复步骤 #

1. 确保Digital Asset Links关联有效性 #

• 确认assetlinks.json文件放置在网站根目录的/.well-known/路径下，格式严格符合要求：

  [{
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "你的应用包名",
      "sha256_cert_fingerprints": ["你的应用签名SHA256指纹"]
    }
  }]
  

• 检查服务器返回该文件时，响应头必须包含Content-Type: application/json，且未设置禁止缓存的相关头。
• 等待1-2小时让Google服务器完成验证同步（存在缓存延迟）。

2. 改用Web Message API设置持久Cookie #

这是CustomTabs中唯一能让Cookie被持久化存储的合法方式，需要应用与网页配合实现：

Android端代码调整

// 创建Session时绑定回调，监听消息通道就绪
val sessionCallback = object : CustomTabsCallback() {
    override fun onMessageChannelReady(session: CustomTabsSession, origin: String) {
        // 向网页发送设置Cookie的指令
        session.postMessage("set_cookie:content-language=FR", origin)
    }
}
val mCustomTabsSession = customTabsClient.newSession(sessionCallback)

// 构建CustomTabsIntent并启用Web Message支持
val intent = CustomTabsIntent.Builder(mCustomTabsSession)
    .setShareIdentityEnabled(true)
    .build()
// 添加Web Message监听，指定允许通信的目标域名
mCustomTabsSession?.addWebMessageListener(
    "https://你的目标域名",
    listOf("set_cookie:*")
)
intent.launchUrl(context, Uri.parse(url))

网页端添加消息监听

window.addEventListener('message', function(event) {
    // 只处理可信来源的消息
    if (event.origin !== 'https://你的目标域名') return;
    if (event.data.startsWith('set_cookie:')) {
        const cookieContent = event.data.split(':')[1];
        // 设置完整Cookie属性，确保被识别为第一方Cookie
        document.cookie = `${cookieContent}; Path=/; Domain=你的目标域名; SameSite=Lax; Secure`;
    }
});

3. 移除无效的EXTRA_HEADERS设置 #

删除代码中通过Browser.EXTRA_HEADERS添加Cookie和content-language的逻辑，避免触发不必要的第三方Cookie拦截警告。

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