ASP.NET Core 9自定义模型绑定无法获取请求体数据问题

核心原因 #

.NET 9的模型绑定流程中，BodyValueProvider不会自动加入普通IModelBinder的ValueProviders集合——它仅在使用[FromBody]标记参数、或采用专门处理请求体的绑定接口时才会被框架注入。以下是针对性的解决方案：

解决方案1：改用IRequestBodyModelBinder接口 #

这是框架专门为请求体绑定设计的接口，会自动让框架注入BodyValueProvider，是最规范的实现方式：

// 自定义请求体绑定器
public class CustomRequestBodyBinder : IRequestBodyModelBinder
{
    public async Task BindModelAsync(ModelBindingContext bindingContext)
    {
        // 此时可直接访问BodyValueProvider
        var bodyProvider = bindingContext.ValueProviders.FirstOrDefault(v => v is BodyValueProvider);
        if (bodyProvider != null)
        {
            // 基于请求体数据执行自定义转换逻辑
        }

        // 完成绑定后返回结果
        var targetModel = new YourCustomModel();
        // 填充模型属性...
        bindingContext.Result = ModelBindingResult.Success(targetModel);
    }
}

// 对应的绑定器提供者
public class CustomRequestBodyBinderProvider : IModelBinderProvider
{
    public IModelBinder? GetBinder(ModelBinderProviderContext context)
    {
        // 指定该绑定器处理的目标模型类型
        if (context.Metadata.ModelType == typeof(YourCustomModel))
        {
            return new CustomRequestBodyBinder();
        }
        return null;
    }
}

在Program.cs中注册提供者：

builder.Services.AddControllers(options =>
{
    // 插入到提供者列表头部，确保优先使用
    options.ModelBinderProviders.Insert(0, new CustomRequestBodyBinderProvider());
});

解决方案2：手动添加BodyValueProvider到普通IModelBinder #

如果坚持使用普通IModelBinder，可以手动读取请求体并创建BodyValueProvider加入上下文：

public class CustomModelBinder : IModelBinder
{
    public async Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var httpContext = bindingContext.HttpContext;
        // 启用流缓冲，确保可多次读取请求体
        httpContext.Request.EnableBuffering();
        
        // 读取请求体内容
        using var reader = new StreamReader(httpContext.Request.Body);
        var bodyContent = await reader.ReadToEndAsync();
        // 重置流位置，避免后续组件读取失败
        httpContext.Request.Body.Position = 0;

        // 创建并插入BodyValueProvider
        var bodyProvider = new BodyValueProvider(
            BindingSource.Body,
            bodyContent,
            System.Globalization.CultureInfo.InvariantCulture);
        
        bindingContext.ValueProviders.Insert(0, bodyProvider);

        // 后续可正常访问BodyValueProvider执行绑定逻辑
    }
}

关键检查项 #

1. 请求Content-Type验证：确保请求头的Content-Type为application/json（或你使用的媒体类型），否则框架不会生成BodyValueProvider。
2. 控制器配置检查：确认Program.cs中已正确注册控制器服务，如builder.Services.AddControllers()；若使用Newtonsoft.Json，需添加.AddNewtonsoftJson()配置。
3. 参数标记冲突：如果参数标记了[FromBody]，需确保自定义绑定器的注册逻辑不会覆盖框架默认的请求体绑定行为。

备选方案：直接解析请求体 #

若上述方案仍无效，可直接读取请求体并手动解析：

public async Task<IActionResult> YourApiAction()
{
    using var reader = new StreamReader(Request.Body);
    var bodyContent = await reader.ReadToEndAsync();
    var jsonNode = JsonNode.Parse(bodyContent);
    
    // 手动映射到目标模型
    var targetModel = new YourCustomModel
    {
        NewProperty = jsonNode["OldPropertyFromApp2014"]?.GetValue<string>(),
        // 其他属性映射逻辑
    };

    // 业务处理逻辑...
    return Ok(targetModel);
}

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