Azure APIM如何通过自定义Header转发并改写后端URI？

完全可以通过APIM的入站策略实现你的需求，无需重复创建多个仅URL存在差异的API。以下是适配你场景的完整策略代码及说明：

核心策略代码 #

<inbound>
    <!-- 提取自定义请求头X-subjectName的值到变量 -->
    <set-variable name="subjectName" value="@(context.Request.Headers.GetValueOrDefault("X-subjectName", ""))" />
    
    <!-- 可选：验证X-subjectName头是否存在且非空，避免无效请求 -->
    <choose>
        <when condition="@(string.IsNullOrEmpty((string)context.Variables["subjectName"]))">
            <return-response>
                <set-status code="400" reason="Bad Request" />
                <set-body>{"error":"X-subjectName请求头不能为空"}</set-body>
            </return-response>
        </when>
    </choose>
    
    <!-- 动态构造后端服务URL，替换为X-subjectName的实际值 -->
    <set-backend-service base-url="https://my.api.com/api/v1/{subjectName}/customers" />
</inbound>

关键说明 #

• 提取请求头：通过context.Request.Headers.GetValueOrDefault获取X-subjectName的值并存入subjectName变量，第二个参数设为空字符串作为默认值，避免头不存在时抛出异常。
• 验证逻辑：添加choose分支判断变量是否为空，若为空直接返回400错误，防止后端收到无效路径的请求。
• 动态设置后端URL：在set-backend-service的base-url中使用{subjectName}引用变量，APIM会自动替换为变量的实际值，最终构造出符合要求的后端地址。

注意事项 #

• 确保APIM实例已正确关联到前端API（https://my-app-api.azure-api.net/api/customers），并将上述策略添加到该API的入站策略中。
• 客户端请求时必须携带有效的Ocp-Apim-Subscription-Key（APIM默认会验证该密钥，无需额外策略，除非你自定义了密钥验证逻辑）和X-subjectName头。

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