GTM加载外部JS文件后代码不执行的问题排查求助

我通过GTM在特定页面加载JS脚本，已创建自定义HTML标签并插入以下代码：

<script type="text/javascript" src="https://www.example.com/assets/js/example.js"></script>

我尝试了初始化、页面浏览、DOM就绪等所有触发器，发布后脚本已被添加到页面DOM中，但JS文件内的代码始终不执行（已在代码顶部添加console.log('test')测试）。

脚本代码如下：

window.addEventListener('load', function () {
   console.log('test');
   ... rest of code here
});

即使注释掉load事件监听器，仅保留核心代码，问题依然存在。但手动将脚本标签添加到页面时，脚本可正常运行无报错。请问我忽略了什么？

• GTM加载时机与脚本逻辑冲突
  当用GTM的自定义HTML标签引用外部脚本时，window.load事件可能在脚本加载完成前就已经触发，导致监听器错过执行时机。另外，GTM插入脚本的上下文可能和手动插入的环境存在差异。
  解决方式：

  1. 直接将脚本内容嵌入GTM的自定义HTML标签，跳过外部引用环节，确保代码在标签触发时直接执行：

     <script>
       console.log('test');
       ... rest of code here
     </script>
     

  2. 若必须引用外部脚本，手动创建脚本元素并添加加载完成回调，主动触发脚本逻辑：

     <script>
       const script = document.createElement('script');
       script.src = 'https://www.example.com/assets/js/example.js';
       script.onload = function() {
         // 直接调用脚本内的核心逻辑，无需等待window.load
         // 例如原脚本有初始化函数则直接执行：initScript()
       };
       document.head.appendChild(script);
     </script>
     

• GTM标签触发顺序问题
  若存在其他标签先于该脚本标签执行，且抛出未捕获错误，可能阻断后续脚本运行；或者标签优先级设置过低，导致脚本插入时机过晚。
  操作：进入GTM标签的「高级」设置，调整「触发顺序」，将该标签的优先级设为更高（数值越小优先级越高），确保它先于可能影响它的标签执行。

• 缓存与发布状态问题
  浏览器可能缓存了旧的GTM容器或脚本文件，导致修改未生效；或者仅在预览模式测试，未正式发布GTM容器。
  解决方式：

  1. 强制刷新页面（Ctrl+F5/Cmd+Shift+R）清除缓存。
  2. 确认GTM容器已完成正式发布，而非停留在预览状态。

• 脚本环境检测逻辑限制
  部分脚本会检测执行环境（比如document.currentScript、特定DOM元素是否存在），GTM的沙箱执行环境可能导致这些检测失败。
  解决方式：检查脚本内的环境判断代码，调整逻辑以适配GTM的执行上下文，比如移除不必要的环境校验。

• GTM标签配置错误
  若勾选了「支持文档写入」选项但脚本未使用document.write，可能导致脚本执行异常。
  操作：在自定义HTML标签的设置中，取消勾选「支持文档写入」选项，保持默认配置。

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