Google Tag Manager(GTM)预览模式故障及关联功能异常求助

问题现象 #

• GTM预览模式无法识别当前已打开页面
• GTM与Google Analytics在受影响页面完全停止工作
• Tag Assistant的Summary区块为空，或仅显示网站部分页面的事件
• 浏览器开发者工具抛出如下错误：

  Uncaught TypeError: Cannot read properties of null (reading 'replace')
  

根因定位 #

该错误由网页的document.referrer值为null导致：当代码尝试对null值调用replace()方法时，会触发类型错误，直接阻断GTM、GA相关脚本的执行流程，引发一系列功能失效问题。

修复方案 #

1. 修复页面自定义脚本：定位页面中直接调用document.referrer.replace()的代码，添加空值判断逻辑，避免对null执行方法：

   // 修复前（错误写法）
   // const processedReferrer = document.referrer.replace(/regex-pattern/, 'replacement');
   
   // 修复后（安全写法）
   const processedReferrer = document.referrer ? document.referrer.replace(/regex-pattern/, 'replacement') : '';
   

2. 排查GTM内部配置：检查GTM中的自定义HTML标签、自定义变量（尤其是引用document.referrer的变量），确保所有调用replace()的逻辑都做了空值兜底处理
3. 验证修复结果：修改完成后刷新页面，确认开发者工具中不再抛出该TypeError，随后测试GTM预览模式、GA数据采集功能是否恢复正常

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