如何通过Azure APIM阻止大文件POST请求？附50MB拦截示例

嘿，刚好我之前折腾过这个需求，用Azure APIM拦截超过50MB的POST请求其实挺直接的，主要靠它的策略（Policy）来实现，下面给你一步步拆解清楚：

核心思路 #

Azure APIM的request-size策略专门用来限制请求体的大小，结合条件判断只作用于POST请求，就能精准拦截超过50MB的文件上传请求。而且这个拦截是在APIM层面完成的，不会把大请求转发到你的后端服务，能有效减轻后端压力。

步骤1：编写策略代码 #

在APIM的**入站策略（Inbound）**中添加以下XML代码：

<choose>
    <!-- 只对POST请求生效 -->
    <when condition="@(context.Request.Method.Equals("POST", StringComparison.OrdinalIgnoreCase))">
        <!-- 设置最大请求大小为50MB（50*1024*1024 = 52428800字节） -->
        <request-size maximum="52428800" />
    </when>
</choose>

代码解释：

• <choose> + <when>：做条件判断，确保只有POST请求会触发大小检查，避免影响GET、PUT等其他请求方法。
• request-size：核心策略，maximum参数设置为52428800字节（即50MB）。当请求大小超过这个阈值时，APIM会直接返回413 Request Entity Too Large的标准HTTP响应，中断请求流程。

步骤2：处理分块编码请求 #

有些客户端发送大文件时会用分块传输（Transfer-Encoding: chunked），这种请求没有Content-Length头，不用担心——request-size策略依然有效，APIM会在接收请求的过程中实时计算已接收的字节数，一旦超过阈值就立刻中断请求，不会等整个文件都接收完。

步骤3：自定义错误响应（可选） #

如果你想返回更友好的自定义错误信息，而不是默认的413响应，可以在策略中添加错误处理逻辑：

<choose>
    <when condition="@(context.Request.Method.Equals("POST", StringComparison.OrdinalIgnoreCase))">
        <request-size maximum="52428800" />
        <!-- 捕获413错误并自定义响应 -->
        <on-error>
            <choose>
                <when condition="@(context.Response.StatusCode == 413)">
                    <return-response>
                        <set-status code="413" reason="Payload Too Large" />
                        <set-body>{"error": "请求文件大小超过50MB限制，请上传更小的文件"}</set-body>
                        <set-header name="Content-Type" exists-action="override">
                            <value>application/json</value>
                        </set-header>
                    </return-response>
                </when>
            </choose>
        </on-error>
    </when>
</choose>

步骤4：在Azure门户配置策略 #

1. 登录Azure门户，打开你的APIM实例。
2. 选择策略应用范围：
   • 全局生效：点击左侧导航栏的「策略」→「全局策略」→「入站处理」的</>图标。
   • 单个API生效：进入目标API的「设计」标签，点击「入站处理」的</>图标。
3. 把上面的XML代码粘贴到入站策略的合适位置（建议放在最前面，尽早拦截大请求）。
4. 保存策略，测试发送一个超过50MB的POST请求，应该会收到你设置的413响应。

这样配置之后，所有超过50MB的POST请求都会被APIM直接拦下，完美符合你的需求～

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