Selenium headless模式运行触发Google Analytics自定义维度已分配报错

报错说明 #

你遇到的报错：

Google Analytics error: tried to send hit payload length in an already assigned custom dimension

翻译为：谷歌分析错误：尝试向已分配的自定义维度发送命中负载长度
该报错触发的核心原因是Chrome 112及以上版本默认启用的新版Headless模式（headless=new）会内置加载谷歌统计相关组件，该组件会提前占用自定义维度存储负载长度，和目标页面自身部署的Google Analytics配置产生冲突。非Headless模式下该内置组件不会默认启用，因此不会触发报错。

可行解决方案 #

• 方案一：添加启动参数禁用Chrome内置统计逻辑
  在ChromeOption配置中添加--disable-background-networking参数，该参数会禁用Chrome后台所有内置统计、更新相关的网络请求，从根源避免内置GA组件和页面GA配置冲突，无需修改其他业务逻辑。
  示例配置（Python）：

  from selenium import webdriver
  options = webdriver.ChromeOptions()
  options.add_argument("--headless=new")
  options.add_argument("--disable-background-networking")
  driver = webdriver.Chrome(options=options)
  

• 方案二：指定使用旧版Headless模式
  明确配置Headless模式为旧版实现，旧版模式不会加载内置GA相关组件，不会产生维度冲突问题。
  示例配置（Python）：

  from selenium import webdriver
  options = webdriver.ChromeOptions()
  options.add_argument("--headless=old")
  driver = webdriver.Chrome(options=options)
  

  注意：该参数仅适配Chrome 112及以上版本，低于该版本的Chrome直接使用--headless参数即可。

• 方案三：注入JS拦截重复维度设置
  如果前两个方案不符合业务场景要求，可在页面加载前注入JS代码，拦截GA重复设置自定义维度的逻辑，避免报错。
  注入示例（Python）：

  driver.execute_cdp_cmd('Page.addScriptToEvaluateOnNewDocument', {
    'source': '''
      window.ga = window.ga || function(...args) {
        if (args[0] === 'set' && args[1].startsWith('dimension') && args[2]?.toString().includes('payloadLength')) return
        window.ga.q = window.ga.q || []
        window.ga.q.push(args)
      }
    '''
  })
  

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