Azure APIM无法记录日志至Event Hub 请求超时故障排查求助

以下是按优先级排序的排查路径，覆盖这类问题的绝大多数根因：

• 策略管道配置校验（最高优先级）
  首先清空所有自定义业务策略，仅在API操作级入站管道末尾保留<mock-response status-code="200" content-type="application/json" />单条策略，用APIM门户自带的测试控制台发起请求验证：
  • 如果此时能正常返回200，说明问题出在策略逻辑/执行顺序上：当前set-body默认读取请求体时不会保留原始内容，后续log-to-eventhub读取请求体的逻辑可能触发内容读取冲突；另外要确认mock-response没有被错误放到出站/错误处理管道节点——该策略会立即终止管道，放错位置会导致APIM持续等待不存在的后端响应，直到触发3分钟默认超时阈值。
  • 如果此时依然报错，说明问题和业务策略、Event Hub配置无关，往下走基线校验。
• APIM部署基线校验
  新建API、甚至全新部署APIM资源都复现问题的场景下，优先排查自动化部署模板的共性配置错误：
  • 网络配置：如果APIM部署在VNet内，检查关联NSG、UDR是否拦截了APIM内部管理流量，是否配置了强制隧道导致APIM内部通信被路由到不可达下一跳，这是内部VNet模式APIM出现无理由502/超时的最高发原因。
  • 策略节点位置：检查全局CORS策略是否被放到了入站管道最开头，若CORS被错误部署到出站/后端阶段，会导致所有请求处理逻辑异常。
  • 后端默认配置：检查是否通过全局策略给所有API配置了默认后端，且因为策略格式错误导致mock-response没有被正确识别、无法触发管道终止，APIM会持续请求不存在的后端直到超时。
  • 模板转义校验：对比本次部署和上一个正常版本的IaC模板差异，检查策略XML的转义是否正确，是否存在XML节点闭合错误、表达式语法错误导致策略执行引擎卡死。
• 日志深度排查
  跳过Application Insights的常规采集，直接在APIM诊断设置中开启GatewayLogs投递到Log Analytics，执行如下查询定位具体报错：

  ApiManagementGatewayLogs
  | where TimeGenerated > ago(1h)
  | where ResponseCode >= 500
  | project TimeGenerated, OperationId, ApiId, PolicyExecutionFailureReason, BackendResponseCode, TotalTime, ErrorMessage
  

  重点关注PolicyExecutionFailureReason字段，该字段会记录策略表达式编译失败、请求体读取异常、logger资源不存在等底层错误，这类错误通常不会被常规监控采集到。
• 资源健康校验
  打开APIM资源的资源健康面板，确认是否存在平台侧上报的网关健康异常；如果是消费层APIM，检查是否触发了实例配额限制。

排查提示：只要单条mock响应策略都无法正常返回，根因一定在APIM基线配置、管道结构、网络层面，和Event Hub、业务payload逻辑没有关联。

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