添加新版Google Analytics代码报HTTP ERROR 500解决方法

500错误是模板解析冲突导致的。从现有代码里的{settings()}、{literal}标签可以判断站点使用Smarty类PHP模板引擎，这类引擎默认会将所有{}包裹的内容识别为模板语法执行解析。你添加的新版GA4代码中包含{dataLayer.push(arguments)}这类带大括号的JS逻辑，模板引擎无法识别该语法，直接抛出服务端解析错误，最终返回500状态码。
之前测试alert("hello");可正常运行，正是因为这段代码没有大括号，不会触发模板解析规则，和GA代码本身的合法性无关。

核心处理逻辑是用模板引擎的{literal}标签包裹GA代码中带大括号的JS部分，告知模板引擎这部分内容不需要解析，直接原样输出到前端即可。

头部部署GA4的正确代码 #

将你之前放在head标签里的GA代码替换为以下版本即可正常运行：

<!-- Global site tag (gtag.js) - Google Analytics -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-替换为你自己的GA4ID"></script>
{literal}
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
  gtag('config', 'G-替换为你自己的GA4ID');
</script>
{/literal}

替换原有页脚旧版GA的正确写法 #

如果要复用原有后台的GA开关、ID配置项，替换页脚旧代码时注意把动态读取配置的逻辑放在{literal}标签外部，参考代码：

{if settings('googleanalytics') == 'yes'}
<script async src="https://www.googletagmanager.com/gtag/js?id={settings('googleanalyticsid')}"></script>
{literal}
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());
{/literal}
  gtag('config', '{settings('googleanalyticsid')}');
{literal}
</script>
{/literal}
{/if}

• 所有包含大括号的前端JS/CSS代码，在这类模板中部署时都需要用{literal}标签包裹，否则都会触发同类解析错误
• 代码替换完成后先清空站点的模板缓存再刷新页面，避免旧的错误缓存导致问题复现
• 部署完成后可打开浏览器开发者工具的Network面板，确认gtag.js请求正常返回，无403/404错误即可

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