GTM服务器端标记预览模式手动配置无法正常工作问题排查

• 请求路径不符合预览实例规则
  GTM服务器端预览实例的请求路径必须带/preview前缀，你当前curl请求的是/g/collect，这是主实例的端点，预览实例不识别这个路径，直接返回404。修正后的curl命令应该是：

  curl -H 'x-gtm-server-preview: ZW52LTN8X1VtScensoredDYxN2M4MDkyMzU3ODRhYzYxOWM==' 'https://preview.mydomain.com/preview/g/collect?v=2&en=page_view&tid=G-1234&cid=123.456&dl=https%3A%2F%2Fexample.com%2F'
  

  同时要检查客户端GTM容器的预览设置，必须将预览目标设为https://preview.mydomain.com/preview（带前缀），否则客户端会把预览请求发去主实例的端点。

• 预览实例未开启预览模式
  部署预览实例时必须设置环境变量GTM_PREVIEW_MODE=true，如果没加这个变量，实例会以普通服务器端模式运行，既不会识别x-gtm-server-preview请求头，也不会监听/preview路径的请求，自然返回404。

• Ingress/反向代理路径重写干扰
  检查K8s Ingress（或Docker用的反向代理）配置：

  • 确认/preview路径被正确转发到预览实例的服务端口
  • 避免配置rewrite-target: /这类会去掉/preview前缀的规则，否则请求到达实例时会变成/g/collect，触发404

• 容器版本不匹配
  确保预览实例使用的GTM服务器端镜像版本和主实例完全一致，不同版本的预览机制、路由规则可能存在差异，导致请求无法被正确处理。

• 预览容器配置缺失预览规则
  检查GTM_CONTAINER_CONFIG_PATH指向的容器配置文件，确认包含预览相关的触发逻辑，否则即使请求到达实例，也不会收集或展示事件。

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