Azure App Service中.NET Framework接口POST被转为GET的异常问题

问题核心 #

部署到Azure App Service后，EndpointA的POST请求被自动转为GET，但本地环境运行正常，EndpointB无此异常。两者的关键差异是：EndpointA的sessionId和transactionId参数使用了[FromUri]修饰，而EndpointB未添加该特性。

触发原因 #

该现象由Azure App Service的IIS配置或ASP.NET参数绑定逻辑差异导致：

• 当POST请求同时包含URI查询参数和请求体时，若URL格式存在问题（比如缺少尾部斜杠），Azure的IIS可能返回301/302重定向响应。
• HttpClient默认会自动跟随重定向，且在这个过程中会将POST请求转为GET请求（HTTP规范默认行为），最终导致EndpointA接收到GET请求，因参数绑定逻辑不匹配而调用失败。

解决方案 #

1. 修正请求URL格式 #

确保调用EndpointA时的callbackUrl末尾包含斜杠：

• 错误示例：https://yourapp.azurewebsites.net/EndpointA
• 正确示例：https://yourapp.azurewebsites.net/EndpointA/

Azure App Service对URL尾部斜杠的处理逻辑与本地IIS存在差异，缺少斜杠容易触发重定向。

2. 调整参数绑定方式 #

移除[FromUri]修饰符，让ASP.NET自动处理参数来源（URI查询参数或请求体）：

[AcceptVerbs("GET", "POST")]
public async Task<HttpResponseMessage> EndpointA(Guid sessionId, Guid transactionId, [FromBody]ADataDTO data)

或者将参数整合到路由中，避免查询参数与请求体混合：

[Route("EndpointA/{sessionId}/{transactionId}")]
[AcceptVerbs("GET", "POST")]
public async Task<HttpResponseMessage> EndpointA(Guid sessionId, Guid transactionId, [FromBody]ADataDTO data)

3. 禁用HttpClient自动重定向 #

修改调用代码，禁止HttpClient自动跟随重定向，避免POST转GET：

public async Task CallEndpointAAsync(string callbackUrl, ADataDTO data)
{
    //... 验证逻辑

    var httpClient = httpClientFactory.CreateClient();
    httpClient.DefaultRequestHeaders.Add("Accept", "application/json");
    httpClient.AllowAutoRedirect = false; // 禁用自动重定向

    var jsonObject = JsonConvert.SerializeObject(data, jsonSerializerSettings);
    var content = new StringContent(jsonObject, Encoding.UTF8, "application/json");
    var response = await httpClient.PostAsync(callbackUrl, content);
    
    // 若需处理重定向，可手动实现逻辑
    if (response.StatusCode == HttpStatusCode.Redirect || response.StatusCode == HttpStatusCode.MovedPermanently)
    {
        var newUrl = response.Headers.Location.ToString();
        await httpClient.PostAsync(newUrl, content);
    }
}

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