如何解决Google Tag Manager(gtm.js)引发的TypeError报错

这个报错和页面上GTM代码的部署位置无关，gtm.js是Google官方托管的稳定版本，不会出现这类基础语法错误，上线数日突然触发报错、仅Chromium系/Safari复现、Firefox正常的特征，完全匹配GTM容器内自定义代码执行冲突的表现。

根因说明 #

GTM会把后台配置的自定义HTML标签、自定义JS变量放在沙箱环境里注入页面执行，当这段自定义代码违反严格模式语法规则时，就会抛出对应错误：

• Chromium内核（Chrome/Edge）抛出Uncaught TypeError: Assignment to constant variable
• Safari抛出TypeError: Attempted to assign to readonly property
• Firefox对沙箱内的这类非致命语法错误做了容错，不会阻断执行，所以无报错
  错误堆栈最顶部的两个<anonymous>执行段，就是自行添加到GTM里的自定义代码，不是gtm.js本体的逻辑。

快速止血方案 #

• 登录GTM后台，打开「版本」菜单，找到报错出现前最后一个正常发布的容器版本，直接回滚发布，1-2分钟内就能恢复站点所有功能正常运行。

精准定位问题代码 #

回滚后可以慢慢排查问题，避免影响线上用户：

• 筛选出报错出现的时间节点之后，所有新增、修改过的配置项，重点排查 自定义HTML标签、自定义JavaScript变量 两类配置，内置的GA4、Google Ads等官方标签不会出现这类问题。
• 开启GTM预览调试模式，复现报错时点击控制台错误堆栈最顶部的<anonymous>条目，会直接跳转到触发报错的代码段，直接定位问题行。
• 重点检查两类错误写法：
  • 用const声明的变量，后续存在重新赋值逻辑，比如const trackData = {}; trackData = {id:1}这类写法
  • 尝试给JS内置只读对象、全局只读属性赋值，比如修改undefined、window.location只读属性、重写原生API的只读配置等

常见踩坑场景 #

• 复制第三方埋点、通用工具代码片段时，误将原代码里的let/var替换成了const，后续逻辑又对该变量做了赋值
• 自定义代码里声明的const变量和GTM沙箱内置的全局常量重名，触发作用域冲突
• 接入的第三方工具自定义脚本本身存在严格模式语法问题，通过GTM自定义HTML标签注入到了页面

永久修复 #

定位到问题代码后：

• 所有需要后续重新赋值的变量，把const声明改成let
• 删除给只读属性/内置对象赋值的逻辑，需要存储值时定义自己的全局变量承接，不要修改原生只读对象
• 修复完成后在预览模式下跨浏览器验证无报错，再重新发布容器版本即可

内容的提问来源于stack exchange，提问作者alice-g