向Google Tag Manager发送数据时出现400 Bad Request问题排查

错误来源判断 #

400 Bad Request错误来源于GTM服务器端主容器，而非Snowbridge。因为Snowbridge仅负责转发请求，只有当请求不符合GTM主容器的接收规则时，才会返回400错误码；若问题出在Snowbridge，通常会出现连接超时、发送失败等日志，而非HTTP 400响应。

可能的原因及排查点 #

• 请求格式不符合主容器要求：GTM服务器端主容器对请求的格式要求比预览模式更严格，需确认：
  • 请求方法是否为POST（GTM服务器端仅接受POST请求）
  • 请求头是否包含正确的Content-Type（需设置为application/json）
  • 请求体的JSON结构是否符合GTM服务器端的规范（比如必须包含events数组、每个事件的name和parameters字段等）
• 主容器启用了请求签名验证：若主容器配置了基于AWS Secrets Manager的请求签名验证，Snowbridge转发请求时未携带正确的x-gtm-server-signature请求头或签名参数，会被GTM拒绝。预览模式默认可能跳过该验证，所以能正常接收。
• Snowbridge的Target配置遗漏关键参数：检查去掉x-gtm-server-preview头后，Snowbridge是否修改了其他请求配置（比如请求路径是否正确指向主容器的/collect端点，而非预览模式的特殊路径）。
• 主容器环境变量配置异常：虽然主容器配置了PREVIEW_SERVER_URL，但该变量仅用于关联预览容器，若主容器的其他核心环境变量（比如CONTAINER_CONFIG）配置错误，也可能导致请求处理失败。

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