复杂类型绑定时[FromBody]的EmptyBodyBehavior被忽略如何解决？

问题现象 #

当在复杂类型的属性上使用[FromBody(EmptyBodyBehavior = EmptyBodyBehavior.Allow)]时，框架会忽略该配置：

• 直接在方法参数上使用[FromBody]的方法（如UpdateAttributes1）能正常允许空请求体；
• 将多个绑定源封装到一个复杂类型中（如UpdateAttributes2的ProductAttributesUpdateRequest类），不传请求体时会返回400错误，提示"A non-empty request body is required."

示例代码：

// 正常工作的方法
[HttpPut("products/{id}/attributes1")]
[ProducesResponseType(typeof(ProductAttributesUpdated), StatusCodes.Status200OK)]
public IActionResult UpdateAttributes1(
    [FromHeader(Name = "X-User")] int userId,
    [FromRoute(Name = "id")] int id,
    [FromBody(EmptyBodyBehavior = EmptyBodyBehavior.Allow)] ProductAttributesUpdate body)
{
    // 省略逻辑
}

// 空请求体报错的方法
[HttpPut("products/{id}/attributes2")]
[ProducesResponseType(typeof(ProductAttributesUpdated), StatusCodes.Status200OK)]
public IActionResult UpdateAttributes2([FromQuery] ProductAttributesUpdateRequest req)
{
    // 省略逻辑
}

public class ProductAttributesUpdateRequest
{
    [FromHeader(Name = "X-User")]
    public int UserId { get; set; }

    [FromRoute(Name = "id")]
    public int Id { get; set; }

    [FromBody(EmptyBodyBehavior = EmptyBodyBehavior.Allow)]
    public ProductAttributesUpdate Body { get; set; }
}

问题原因 #

ASP.NET Core模型绑定系统中，方法参数上的绑定源属性（如[FromQuery]）会主导整个复杂类型的绑定流程，属性级别的[FromBody]配置会被降级处理，其中的EmptyBodyBehavior不会被默认绑定逻辑解析，导致空请求体触发必填校验。

解决方案 #

方案1：自定义模型绑定器（推荐） #

创建自定义绑定器显式处理EmptyBodyBehavior.Allow的逻辑：

1.1 实现绑定器与绑定器提供器

public class AllowEmptyBodyModelBinder : IModelBinder
{
    private readonly IModelBinder _defaultBinder;

    public AllowEmptyBodyModelBinder(IModelBinder defaultBinder)
    {
        _defaultBinder = defaultBinder;
    }

    public async Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var request = bindingContext.HttpContext.Request;
        var fromBodyAttr = bindingContext.ModelMetadata.PropertyAttributes
            .OfType<FromBodyAttribute>()
            .FirstOrDefault();

        // 检测到允许空Body且请求体为空时，直接返回null
        if (fromBodyAttr?.EmptyBodyBehavior == EmptyBodyBehavior.Allow 
            && request.ContentLength == 0 
            && string.IsNullOrEmpty(request.ContentType))
        {
            bindingContext.Result = ModelBindingResult.Success(null);
            return;
        }

        // 非空情况使用默认绑定器处理
        await _defaultBinder.BindModelAsync(bindingContext);
    }
}

public class AllowEmptyBodyModelBinderProvider : IModelBinderProvider
{
    public IModelBinder GetBinder(ModelBinderProviderContext context)
    {
        if (context == null) throw new ArgumentNullException(nameof(context));

        var fromBodyAttr = context.Metadata.PropertyAttributes
            .OfType<FromBodyAttribute>()
            .FirstOrDefault();
        
        // 仅为标记了允许空Body的属性提供自定义绑定器
        if (fromBodyAttr?.EmptyBodyBehavior == EmptyBodyBehavior.Allow)
        {
            var defaultBinder = context.CreateBinder(context.Metadata);
            return new AllowEmptyBodyModelBinder(defaultBinder);
        }

        return null;
    }
}

1.2 注册绑定器

在Program.cs中注入自定义绑定器提供器：

builder.Services.AddControllers(options =>
{
    // 将自定义绑定器置于默认绑定器之前
    options.ModelBinderProviders.Insert(0, new AllowEmptyBodyModelBinderProvider());
});

方案2：拆分方法参数（最简） #

放弃复杂类型封装，直接将各绑定源参数拆分到方法签名中，框架会正确识别[FromBody]的EmptyBodyBehavior配置，如第一个UpdateAttributes1方法的写法。

方案3：手动处理请求体 #

在复杂类型中添加手动绑定请求体的方法，绕过默认模型绑定的限制：

public class ProductAttributesUpdateRequest
{
    [FromHeader(Name = "X-User")]
    public int UserId { get; set; }

    [FromRoute(Name = "id")]
    public int Id { get; set; }

    public ProductAttributesUpdate Body { get; set; }

    public async Task BindBodyAsync(HttpRequest request)
    {
        if (request.ContentLength == 0 || string.IsNullOrEmpty(request.ContentType))
        {
            Body = null;
            return;
        }
        Body = await request.ReadFromJsonAsync<ProductAttributesUpdate>();
    }
}

在控制器方法中调用该绑定方法：

[HttpPut("products/{id}/attributes2")]
[ProducesResponseType(typeof(ProductAttributesUpdated), StatusCodes.Status200OK)]
public async Task<IActionResult> UpdateAttributes2([FromQuery] ProductAttributesUpdateRequest req)
{
    await req.BindBodyAsync(HttpContext.Request);
    // 后续业务逻辑
}

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