如何配置APIM在后端返回错误时无需接收完整请求就立即返回Bad Request

实现结论 #

可以通过调整APIM的请求缓冲配置实现需求，无需等待完整请求接收完成即可返回后端抛出的错误响应。

具体配置步骤 #

• 关闭请求体缓冲
  APIM默认开启请求体缓冲机制，会完整接收客户端上传的所有请求内容后才转发给后端服务，这是导致错误响应延迟的核心原因。你可以在对应API的入站策略中添加buffer-request-body配置，显式关闭缓冲：

<policies>
    <inbound>
        <base />
        <!-- 关闭请求体缓冲，以流模式转发请求到后端 -->
        <buffer-request-body enabled="false" />
        <set-backend-service backend-id="你的App Service对应后端ID" />
    </inbound>
    <backend>
        <base />
    </backend>
    <outbound>
        <base />
    </outbound>
    <on-error>
        <base />
    </on-error>
</policies>

配置生效后，APIM会以流的形式持续将接收到的请求内容转发给后端，一旦后端返回Bad Request等错误响应，APIM会立刻停止接收剩余的客户端请求内容，直接将错误响应返回给客户端。

注意事项 #

• 关闭请求体缓冲后，无法在APIM的入站阶段执行请求体读取、修改、校验等操作，如果有APIM层的请求校验需求，建议将不涉及大文件的校验参数放到请求头中提前处理，或通过条件策略仅对大文件上传接口关闭缓冲。
• 消费层、开发层的APIM实例对流式转发的性能支持有限，大流量场景下建议使用标准层及以上规格的APIM实例。
• 如需保留部分接口的请求缓冲能力，可以通过choose条件策略，仅对匹配大文件上传路径、请求头的请求关闭缓冲，兼顾其他接口的功能稳定性。

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