咨询Azure APIM处理form-data图片上传及后端调用的政策编写方案

Hey Amit, 刚上手Azure APIM确实会遇到不少细节问题，尤其是处理multipart/form-data这种二进制请求的时候。我帮你梳理一套完整的APIM政策方案，刚好匹配你要实现的「存Blob+调用后端API」需求，一步步来：

我们需要在APIM的inbound阶段完成三件事：

1. 解析前端传来的form-data请求，提取出图片文件的二进制内容和文件名
2. 调用Azure Blob存储的API，把图片存到指定容器
3. 把图片转成后端API支持的JSON格式，转发请求并获取处理结果

1. 解析Form-Data提取图片文件 #

首先从multipart/form-data请求里提取图片数据，用APIM上下文变量暂存：

<!-- 提取form-data中的图片文件，假设前端上传的字段名是"file" -->
<set-variable name="imageFile" value="@(context.Request.Body.AsFormData().Files["file"])" />
<set-variable name="imageContent" value="@(((System.Web.HttpPostedFileWrapper)context.Variables["imageFile"]).Content)" />
<set-variable name="imageFileName" value="@(((System.Web.HttpPostedFileWrapper)context.Variables["imageFile"]).FileName)" />

注：如果前端上传的字段名不是"file"，记得把代码里的"file"改成对应字段名

2. 将图片存储到Azure Blob存储 #

用APIM的<send-request>政策调用Blob的REST API，搭配托管身份（Managed Identity）做安全授权：

<!-- 调用Blob存储的Put Blob接口，替换为你的存储账户名和容器名 -->
<send-request mode="new" response-variable-name="blobUploadResponse" timeout="20" ignore-error="false">
    <set-url>@($"https://{你的存储账户名}.blob.core.windows.net/{你的容器名}/{context.Variables["imageFileName"]}")</set-url>
    <set-method>PUT</set-method>
    <set-header name="x-ms-blob-type" exists-action="override">
        <value>BlockBlob</value>
    </set-header>
    <set-body>@(context.Variables["imageContent"])</set-body>
    <!-- 用托管身份授权，需提前给APIM的MI分配Blob存储的"Storage Blob Data Contributor"权限 -->
    <authentication-managed-identity resource="https://storage.azure.com/" />
</send-request>

前置准备：要先在APIM里启用托管身份，然后到Blob存储的IAM页面给这个MI分配权限，避免硬编码密钥

3. 调用后端API处理图片 #

你提到后端支持JSON格式的图片，我们把二进制图片转成Base64字符串，包装成JSON请求体后转发：

<!-- 重置请求体为后端需要的JSON格式 -->
<set-body>@{
    var imageBase64 = Convert.ToBase64String((byte[])context.Variables["imageContent"]);
    // 可根据后端API要求调整JSON字段名
    return JsonConvert.SerializeObject(new { 
        image = imageBase64, 
        fileName = context.Variables["imageFileName"] 
    });
}</set-body>

<!-- 设置请求头匹配后端的JSON格式要求 -->
<set-header name="Content-Type" exists-action="override">
    <value>application/json</value>
</set-header>

<!-- 转发请求到你的后端API -->
<forward-request />

• 政策顺序：以上所有政策都要放在APIM的inbound阶段，顺序必须是「解析form-data → 上传Blob → 重置请求体转发后端」
• 错误处理：可以添加判断逻辑避免空文件上传，比如：

  <choose>
      <when condition="@(context.Request.Body.AsFormData().Files.Count == 0)">
          <return-response>
              <set-status code="400" reason="Bad Request" />
              <set-body>{"error": "请求中未找到图片文件"}</set-body>
          </return-response>
      </when>
  </choose>
  

• 性能优化：如果图片过大，要检查APIM的请求大小限制，必要时在APIM实例设置里调整；若业务允许，也可以考虑异步处理Blob上传和后端调用。

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