如何让ASP.NET Core 2.0 MVC无需FromBody绑定复杂类型并兼容旧WebAPI

当然可以做到！ASP.NET Core的模型绑定系统其实相当灵活，完全能让你实现类似旧版WebAPI那样自动将JSON请求体绑定到复杂类型参数的效果，还能精准控制只对特定控制器或控制器组生效。下面给你一步步拆解具体实现：

1. 定义标记特性（用于指定适用范围） #

首先我们先创建一个自定义特性，用来标记哪些控制器/Action需要启用自动从Body绑定复杂类型的规则：

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method)]
public class AutoFromBodyAttribute : Attribute
{
    // 空特性，仅作为标记用
}

2. 自定义模型绑定提供器 #

接下来我们需要实现一个IModelBinderProvider，它是模型绑定的“调度员”，负责决定什么时候用Body绑定器来处理参数：

public class AutoFromBodyModelBinderProvider : IModelBinderProvider
{
    private readonly BodyModelBinderProvider _originalBodyProvider;

    // 注入内置的BodyModelBinderProvider，我们要复用它的逻辑
    public AutoFromBodyModelBinderProvider(BodyModelBinderProvider originalBodyProvider)
    {
        _originalBodyProvider = originalBodyProvider;
    }

    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        // 第一步：检查当前控制器/Action是否标记了我们的AutoFromBody特性
        var hasAutoFromBodyAttribute = context.ActionContext.ActionDescriptor.EndpointMetadata.Any(
            metadata => metadata is AutoFromBodyAttribute);

        if (!hasAutoFromBodyAttribute)
        {
            return null; // 没标记的话，走默认绑定逻辑
        }

        // 第二步：判断是否是需要自动绑定的复杂类型
        var modelType = context.Metadata.ModelType;
        // 排除简单类型、字符串、数组、集合、字典这些，它们还是走默认绑定（比如从QueryString）
        if (modelType.IsPrimitive || 
            modelType == typeof(string) ||
            modelType.IsArray ||
            typeof(ICollection).IsAssignableFrom(modelType) ||
            typeof(IDictionary).IsAssignableFrom(modelType))
        {
            return null;
        }

        // 第三步：只针对POST/PUT/PATCH这类通常带请求体的HTTP方法生效
        var requestMethod = context.ActionContext.HttpContext.Request.Method;
        if (!new[] { "POST", "PUT", "PATCH" }.Contains(requestMethod, StringComparer.OrdinalIgnoreCase))
        {
            return null;
        }

        // 最后：复用内置的BodyModelBinder来完成实际的绑定工作
        return _originalBodyProvider.GetBinder(context);
    }
}

3. 注册自定义提供器到MVC服务 #

在Program.cs里，我们需要把自定义的提供器替换掉内置的BodyModelBinderProvider：

var builder = WebApplication.CreateBuilder(args);

// 添加MVC服务并配置模型绑定提供器
builder.Services.AddControllersWithViews(options =>
{
    // 找到内置的BodyModelBinderProvider实例
    var originalBodyProvider = options.ModelBinderProviders.OfType<BodyModelBinderProvider>().FirstOrDefault();
    if (originalBodyProvider != null)
    {
        // 用我们的自定义提供器替换它
        var index = options.ModelBinderProviders.IndexOf(originalBodyProvider);
        options.ModelBinderProviders[index] = new AutoFromBodyModelBinderProvider(originalBodyProvider);
    }
});

var app = builder.Build();

// 中间件配置...
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

4. 给目标控制器/Action添加标记 #

现在只要给需要自动绑定的控制器加上[AutoFromBody]特性，里面的复杂类型参数就不用再加[FromBody]了：

[AutoFromBody]
public class LegacyApiController : Controller
{
    [HttpPost]
    public IActionResult CreateProduct(ProductCreateDto model)
    {
        // 这里model会自动从JSON请求体绑定，无需[FromBody]
        if (ModelState.IsValid)
        {
            // 处理逻辑...
            return Ok(model);
        }
        return BadRequest(ModelState);
    }

    [HttpPut("{id}")]
    public IActionResult UpdateProduct(int id, ProductUpdateDto model)
    {
        // 同样自动绑定
        return Ok();
    }
}

官方之所以这么设计，主要是因为MVC和WebAPI的定位差异：MVC最初更多处理表单提交，模型绑定默认会从QueryString、FormData等多个来源取值；而WebAPI专注于RESTful接口，默认复杂类型从Body绑定。后来两者合并后，为了兼顾兼容性和安全性（避免误用导致的CSRF风险或绑定错误），官方要求显式添加[FromBody]来明确绑定来源。不过如果你明确知道自己的场景是JSON接口，用上面的方法完全没问题。

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