通过内部模式APIM访问本地API时出现500内部服务器错误

• 检查网络访问前提
  内部模式下APIM仅允许所在虚拟网络（含对等网络）或通过VPN/ExpressRoute接入的网络访问。先确认发起curl -X GET https://apim-gateway-example.com的机器处于上述合规网络内，否则请求无法正常触达网关，可能触发500错误。可在同网络内机器执行curl -v https://apim-gateway-example.com，验证TCP连接是否能建立。

• 验证本地API自身可用性
  从APIM网关所在子网的测试虚拟机，直接访问本地API地址（例如curl http://local-api-ip:port/path），确认本地API能正常返回响应，无内部错误。若本地API本身故障，APIM会返回500错误。

• 检查APIM的API配置项

  • 确认API后端URL配置正确，且该地址在APIM所在VNet内可解析（需配置对应私有DNS区域或本地DNS转发）。
  • 排查自定义策略是否存在错误，比如错误的转发规则、未正确配置的认证/限流策略。可临时移除所有自定义策略后重试，判断是否由策略导致。

• 查看APIM日志定位具体原因
  登录Azure门户进入APIM实例：

  • 查看「监控」模块下的网关日志，追踪请求处理流程，排查是否存在后端连接超时、DNS解析失败、认证失败等具体异常。
  • 通过「诊断设置」导出日志至Log Analytics，搜索对应请求ID，获取详细错误堆栈信息。

• 确认APIM内部模式及网络规则配置

  • 核实APIM确实处于内部模式，网关私有IP归属正确子网。
  • 检查子网NSG规则，确保允许APIM网关与本地API之间的流量（开放API对应的端口）。

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