.NET 7 Minimal API中AsParametersAttribute无法正确映射请求模型

我正在实现一个基于MediatR的简单通用Minimal API方法映射器，在POST接口中使用AsParametersAttribute接收请求体数据时，遇到了请求模型无法映射的问题。已确认官方文档中该用法是可行的，但存在以下异常情况：

• 使用AsParametersAttribute时，请求模型SignInRequest中无任何数据
• 使用FromBodyAttribute时，模型能正常获取请求体数据
• 尝试将SignInRequest改为class、record struct，搭配[AsParameters]均无效；IHttpRequest是对MediatR的IResult<TResponse>的简化封装，包含自定义响应模型

原因分析 #

AsParametersAttribute的设计初衷是将多个分散的请求参数（如Query参数、路由参数、Header参数等）聚合绑定到一个模型类，它并不负责解析POST请求体的JSON数据，这就是使用它时模型没有数据的核心原因。

可行方案 #

方案1：结合FromBody实现原生绑定 #

这是最符合ASP.NET Core设计规范的方案，直接在通用映射逻辑中为请求模型添加[FromBody]特性，确保框架正确解析JSON请求体：

// 通用MediatR POST映射扩展方法
public static RouteGroupBuilder MapMediatRPost<TRequest, TResponse>(this RouteGroupBuilder group, string route)
    where TRequest : IHttpRequest<TResponse>
{
    group.MapPost(route, async ([FromBody] TRequest request, IMediator mediator) =>
    {
        var mediatrResult = await mediator.Send(request);
        return Results.Ok(mediatrResult);
    });
    return group;
}

方案2：自定义模型绑定器适配AsParameters #

如果一定要使用AsParametersAttribute，可以通过自定义模型绑定器让它支持从请求体解析数据：

1. 实现自定义模型绑定器：

public class BodyAsParametersBinder : IModelBinder
{
    private readonly JsonSerializerOptions _jsonOptions;

    public BodyAsParametersBinder(IOptions<JsonOptions> jsonOptions)
    {
        _jsonOptions = jsonOptions.Value.SerializerOptions;
    }

    public async Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var httpRequest = bindingContext.HttpContext.Request;
        using var streamReader = new StreamReader(httpRequest.Body);
        var jsonContent = await streamReader.ReadToEndAsync();
        
        var model = JsonSerializer.Deserialize(jsonContent, bindingContext.ModelType, _jsonOptions);
        if (model != null)
        {
            bindingContext.Result = ModelBindingResult.Success(model);
        }
        else
        {
            bindingContext.ModelState.TryAddModelError(bindingContext.ModelName, "请求体解析失败");
        }
    }
}

2. 为请求模型绑定自定义绑定器：

[ModelBinder(BinderType = typeof(BodyAsParametersBinder))]
public record SignInRequest(string Username, string Password) : IHttpRequest<SignInResponse>;

3. 此时即可使用[AsParameters]绑定模型：

group.MapPost("/signin", async ([AsParameters] SignInRequest request, IMediator mediator) =>
{
    var result = await mediator.Send(request);
    return Results.Ok(result);
});

注意事项 #

• 优先选择方案1，无需额外自定义逻辑，完全贴合ASP.NET Core原生参数绑定机制，稳定性和可维护性更高。
• AsParametersAttribute的最佳适用场景是GET请求的多Query/路由参数聚合，POST请求体建议始终使用[FromBody]进行绑定。

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