.NET 6 Web API全局支持JSON与x-www-form-urlencoded格式方案

首先明确：不需要移除ApiController特性，也不需要修改继承ControllerBase，问题出在.NET 6中ApiController的默认模型绑定行为，以及表单数据绑定的限制。

问题根源 #

ApiController特性会自动为复杂类型参数（比如你的FooRequestModel）隐含添加[FromBody]绑定源，这意味着框架只会从请求体的JSON格式中解析数据。而application/x-www-form-urlencoded格式的请求，即便请求体是表单数据，默认规则下要么因绑定源限制无法匹配，要么无法处理嵌套结构的模型绑定。

全局解决方案（无需逐个端点配置） #

方案1：全局调整模型绑定源规则（适配所有复杂类型）

通过配置MvcOptions，修改ApiController的默认绑定逻辑，让复杂类型同时支持从JSON请求体和表单数据绑定：

在Program.cs中添加以下代码：

builder.Services.AddControllers(options =>
{
    // 全局添加支持的内容类型，替代逐个控制器配置[Consumes]
    options.Filters.Add(new ConsumesAttribute("application/json", "application/x-www-form-urlencoded"));
    
    // 为自定义复杂类型指定允许从任意源绑定
    options.ModelMetadataDetailsProviders.Add(new BindingSourceMetadataProvider(typeof(FooRequestModel), BindingSource.Any));
})
.AddJsonOptions(options =>
{
    // 可选：配置JSON序列化规则，比如忽略大小写匹配
    options.JsonSerializerOptions.PropertyNameCaseInsensitive = true;
});

该方案通过BindingSourceMetadataProvider为FooRequestModel设置绑定源为Any，允许框架从请求体（JSON）、表单集合（x-www-form-urlencoded）等任意可用源绑定数据，实现全局兼容两种格式。

方案2：自定义模型绑定器（适配嵌套对象场景）

如果你的FooRequestModel包含嵌套对象，默认的FormUrlEncodedInputFormatter无法解析嵌套结构，此时可以自定义全局模型绑定器，同时支持JSON和表单数据的绑定：

1. 自定义模型绑定器提供器和绑定器：

public class MultiSourceModelBinderProvider : IModelBinderProvider
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        // 仅为自定义复杂类型应用该绑定器
        if (context.Metadata.ModelType == typeof(FooRequestModel))
        {
            var bodyBinder = new BodyModelBinder(context.Services.GetRequiredService<IOptions<MvcOptions>>().Value.InputFormatters);
            var formBinder = new FormModelBinder(context.Services.GetRequiredService<IModelMetadataProvider>());
            return new CompositeModelBinder(new List<IModelBinder> { bodyBinder, formBinder });
        }
        return null;
    }
}

2. 在Program.cs中注册该绑定器：

builder.Services.AddControllers(options =>
{
    options.Filters.Add(new ConsumesAttribute("application/json", "application/x-www-form-urlencoded"));
    // 将自定义绑定器放在最前面，优先使用
    options.ModelBinderProviders.Insert(0, new MultiSourceModelBinderProvider());
});

这个绑定器会同时尝试从请求体（解析JSON）和表单集合（解析x-www-form-urlencoded）获取数据，适配嵌套对象的绑定需求。

额外修正与注意事项 #

• 你的示例代码中路由参数userId的特性错误，应该用[FromRoute]而非[FromQuery]，修正后的方法签名：

public async Task<IActionResult> Foo(FooRequestModel model, [FromRoute] string userId)

• 测试时务必确保请求的Content-Type头正确：JSON请求设为application/json，表单请求设为application/x-www-form-urlencoded。
• 若使用扁平结构的模型，方案1已足够覆盖需求；若有嵌套对象，优先选择方案2。

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