如何实现FromQuery with FromBody fallback：按请求方式绑定接口属性

我刚好在项目里实现过一模一样的需求，给你拆解下两种可行的方案，你可以根据自己的场景选：

方案一：Action重载（简单直接，适合单接口场景） #

这种方式不需要写任何自定义组件，利用ASP.NET Core的路由匹配规则，给同一个路由写两个Action，分别处理GET和POST请求：

1. 定义请求模型 #

先把需要绑定的字段封装成模型类：

public class UserRequest
{
    [Required]
    public string Username { get; set; }
    public int? Age { get; set; }
    public string Email { get; set; }
}

2. 编写重载的Action #

给同一个路由分别写GET和POST版本的Action，各自用对应的绑定属性：

[ApiController]
[Route("api/users")]
public class UsersController : ControllerBase
{
    // GET请求：从QueryString绑定
    [HttpGet]
    public IActionResult GetUser([FromQuery] UserRequest request)
    {
        if (!ModelState.IsValid)
        {
            return BadRequest(ModelState);
        }
        return ProcessUserRequest(request);
    }

    // POST请求：从请求体绑定（自动支持JSON和表单）
    [HttpPost]
    public IActionResult PostUser([FromBody] UserRequest request)
    {
        if (!ModelState.IsValid)
        {
            return BadRequest(ModelState);
        }
        return ProcessUserRequest(request);
    }

    // 把业务逻辑抽成私有方法，避免重复代码
    private IActionResult ProcessUserRequest(UserRequest request)
    {
        // 这里写你的业务处理逻辑，比如返回请求数据
        return Ok(new { Message = "请求处理成功", Data = request });
    }
}

为什么支持JSON和表单？ #

ASP.NET Core默认已经注册了JsonInputFormatter和FormUrlEncodedInputFormatter，只要POST请求的Content-Type是application/json（JSON格式）或者application/x-www-form-urlencoded（表单编码），框架会自动完成绑定，不需要额外配置。

方案二：自定义模型绑定器（优雅复用，适合多接口场景） #

如果你的项目里有很多接口都需要这种“GET用Query，POST用Body”的逻辑，写一堆重载Action就太冗余了，这时候自定义模型绑定器是更好的选择：

1. 编写自定义模型绑定器 #

这个绑定器会根据请求方法自动选择绑定源：

public class QueryOrBodyBinder : IModelBinder
{
    private readonly IModelBinder _queryBinder;
    private readonly IModelBinder _bodyBinder;

    // 通过构造函数注入默认的Query和Body绑定器
    public QueryOrBodyBinder(IModelBinder queryBinder, IModelBinder bodyBinder)
    {
        _queryBinder = queryBinder;
        _bodyBinder = bodyBinder;
    }

    public async Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var httpContext = bindingContext.HttpContext;
        
        // 判断请求方法，选择对应的绑定器
        if (httpContext.Request.Method.Equals(HttpMethods.Get, StringComparison.OrdinalIgnoreCase))
        {
            await _queryBinder.BindModelAsync(bindingContext);
        }
        else
        {
            await _bodyBinder.BindModelAsync(bindingContext);
        }
    }
}

2. 编写绑定器提供程序 #

这个类负责告诉框架什么时候使用我们的自定义绑定器：

public class QueryOrBodyBinderProvider : IModelBinderProvider
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        // 这里指定我们的绑定器只作用于UserRequest模型（如果要全局生效，可以去掉这个判断）
        if (context.Metadata.ModelType != typeof(UserRequest))
        {
            return null;
        }

        // 获取框架默认的Query绑定器
        var queryBinder = context.CreateBinder(new ModelBinderProviderContext
        {
            Metadata = context.Metadata,
            BindingInfo = new BindingInfo { BindingSource = BindingSource.Query }
        });

        // 获取框架默认的Body绑定器
        var bodyBinder = context.CreateBinder(new ModelBinderProviderContext
        {
            Metadata = context.Metadata,
            BindingInfo = new BindingInfo { BindingSource = BindingSource.Body }
        });

        return new QueryOrBodyBinder(queryBinder, bodyBinder);
    }
}

3. 注册绑定器 #

在Program.cs（或者Startup.cs）里把自定义绑定器注册到框架中：

var builder = WebApplication.CreateBuilder(args);

// 添加控制器服务，并注册自定义模型绑定器
builder.Services.AddControllers(options =>
{
    // 把我们的绑定器放在最前面，确保优先被使用
    options.ModelBinderProviders.Insert(0, new QueryOrBodyBinderProvider());
});

var app = builder.Build();

// 其他中间件配置...
app.MapControllers();
app.Run();

4. 编写单Action接口 #

现在只需要写一个Action，框架会自动根据请求方法选择绑定方式：

[ApiController]
[Route("api/users")]
public class UsersController : ControllerBase
{
    [HttpGet]
    [HttpPost]
    public IActionResult HandleUserRequest(UserRequest request)
    {
        if (!ModelState.IsValid)
        {
            return BadRequest(ModelState);
        }
        // 业务逻辑
        return Ok(new { Message = "请求处理成功", Data = request });
    }
}

可选：给模型类加标记 #

如果不想全局注册绑定器，也可以直接在模型类上标记使用我们的绑定器：

[ModelBinder(BinderType = typeof(QueryOrBodyBinder))]
public class UserRequest
{
    // 属性...
}

这样不需要修改Program.cs，框架也会对这个模型使用自定义绑定逻辑。

注意事项 #

• 不管用哪种方案，都要记得检查ModelState.IsValid，确保绑定的参数符合验证规则；
• 如果POST请求是表单数据，要确保表单字段名和模型属性名一致（大小写不敏感，但建议保持一致）；
• 复杂类型（比如嵌套模型）两种方案都能完美支持，和框架默认的绑定逻辑一致。

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