.NET 6 WebAPI中HttpMethodOverrideMiddleware转POST为PUT失效问题

这个行为不正常，核心问题出在中间件的执行顺序上，导致路由匹配时未使用修改后的请求方法。

原因 #

HttpMethodOverrideMiddleware的作用是修改请求的Method属性，但它需要在路由匹配操作之前执行，这样路由系统才能基于修改后的方法匹配对应的控制器Action。你的代码中，UseHttpMethodOverride的位置在UseAuthorization之后、MapControllers之前，而.NET 6中MapControllers会自动触发路由匹配逻辑，导致路由匹配时请求方法还是原始的POST，之后中间件才将方法改为PUT，因此仍然命中POST方法。

解决方案 #

调整中间件顺序，将UseHttpMethodOverride放在路由相关中间件（UseRouting）之前，确保路由匹配时使用的是修改后的请求方法。

修改后的Program.cs代码：

namespace middlewareTesting
{
    public class Program
    {
        public static void Main(string[] args)
        {
            var builder = WebApplication.CreateBuilder(args);

            builder.Services.AddControllers();
            builder.Services.AddEndpointsApiExplorer();
            builder.Services.AddSwaggerGen();

            var app = builder.Build();

            app.UseForwardedHeaders(new ForwardedHeadersOptions
            {
                ForwardedHeaders = ForwardedHeaders.XForwardedFor | ForwardedHeaders.XForwardedProto
            });

            // 将UseHttpMethodOverride移至路由匹配前执行
            app.UseHttpMethodOverride();

            if (app.Environment.IsDevelopment())
            {
                app.UseSwagger();
                app.UseSwaggerUI();
            }

            app.UseHttpsRedirection();

            // 显式声明路由匹配中间件，确保执行顺序正确
            app.UseRouting();

            app.UseAuthorization();

            app.MapControllers();

            app.Run();
        }
    }
}

验证 #

重新运行项目后，用Postman发送POST请求到/WeatherForecast，添加请求头X-HTTP-Method-Override: PUT，此时请求会正确命中Put方法，返回"PUT WAS HIT"。

额外说明 #

• 不需要在POST方法中做任何额外处理，只要中间件顺序正确，路由系统会自动根据修改后的请求方法匹配对应的Action。
• 若你没有显式调用UseRouting，MapControllers会在内部自动添加路由匹配逻辑，但显式声明能更清晰地控制中间件执行顺序。

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