Google GA4 batchRunReports无结果时携带TOTAL聚合触发500错误

这是GA4 Data API v1alpha版本batchRunReports接口的已知服务端bug：当查询的过滤条件完全匹配不到任何业务数据行时，服务端在处理metricAggregations: ["TOTAL"]的全量聚合计算分支时会触发内部空值异常，直接抛出没有明确错误提示的500内部错误。短时间内多次触发这类异常，会触发API服务的风控阈值，导致对应Google Cloud项目的接口调用权限被临时封禁1小时。
已经验证的触发规律：只有请求同时满足「无匹配业务数据」+「配置了metricAggregations聚合规则」两个条件才会触发异常，去掉聚合配置后，哪怕无匹配数据，接口也能正常返回空结构响应，不会报错。

• 前置轻量探活预检
  在正式发起带metricAggregations的批量报告请求前，先跑一次极简预检请求：只保留核心的propertyId、维度列表、指标列表、过滤规则、日期范围配置，把metricAggregations、orderBys、keepEmptyRows这些参数全部去掉，分页大小设为1。如果预检返回的结果集里没有任何数据行，直接跳过后续带聚合配置的正式请求，从根源上绕开触发500的分支。
• 拆分请求逻辑兜底
  如果业务场景必须依赖TOTAL类型的聚合结果值，不要在同一个请求里同时返回明细行和聚合值，拆成两个独立请求调用：
  1. 先调用不带任何聚合配置的接口拿匹配的明细数据
  2. 如果明细结果为空，直接在本地构造聚合值为0的响应结构，不用额外发聚合计算请求
  3. 如果明细结果非空，再单独发起一次不带任何维度的纯聚合请求（只配日期范围、过滤规则、指标、metricAggregations）拿全量合计值，这类无维度的纯聚合请求在无数据场景下不会触发当前的500bug。
• 高风险请求熔断防护
  在API客户端层加异常识别规则：只要捕获到状态码500、状态为INTERNAL、错误消息为"Internal error encountered"的GA4 API响应，立刻给当前请求的维度组合、过滤规则、日期范围生成唯一识别指纹，把这个指纹对应的请求标记为高风险触发项，24小时内不再对同指纹的请求发带metricAggregations的调用，避免反复触发错误导致接口权限被锁。
• 冗余参数精简优化
  把子请求里重复配置的entity字段删掉，统一把propertyId的配置放到最外层的batch请求结构里，减少服务端参数解析的分支逻辑，降低触发内部异常的概率。

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