ASP.NET Core中如何将路由PersonId映射到命令对象，避免请求体重复传递

下面提供三种实用方案，帮你把路由里的personId自动赋值给AddWorkExperienceCommand，无需在请求体重复传参：

方法一：控制器内手动赋值（最简单直接） #

直接在控制器方法参数里接收路由的personId，手动赋值给命令对象，无需额外配置：

[HttpPost("{personId:guid}/workExperience")]
public async Task<IActionResult> AddWorkExperienceAsync(
    [FromRoute] Guid personId, // 接收路由参数
    [FromBody] AddWorkExperienceCommand command,
    [FromServices] IMediator mediator,
    CancellationToken cancellationToken)
{
    // 将路由的personId赋值给命令对象
    command.PersonId = personId;
    
    var result = await mediator.Send(command, cancellationToken);
    return Created(nameof(GetByIdAsync), result);
}

方法二：自定义模型绑定器（适合全局复用） #

如果多个命令都需要类似的路由参数映射，可以编写通用模型绑定器，自动从路由取值赋值给模型属性：

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

public class RouteToCommandBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        if (bindingContext == null)
            throw new ArgumentNullException(nameof(bindingContext));

        // 从路由获取personId
        var personIdValue = bindingContext.HttpContext.Request.RouteValues["personId"]?.ToString();
        if (Guid.TryParse(personIdValue, out Guid personId))
        {
            // 初始化命令对象并赋值路由参数
            var command = new AddWorkExperienceCommand { PersonId = personId };
            
            // 读取请求体数据并合并到命令对象
            var bodyModel = bindingContext.HttpContext.Request
                .ReadFromJsonAsync<AddWorkExperienceCommand>(bindingContext.HttpContext.RequestAborted)
                .Result;
            
            if (bodyModel != null)
            {
                // 用反射合并请求体属性（也可使用AutoMapper简化）
                foreach (var prop in typeof(AddWorkExperienceCommand).GetProperties())
                {
                    var value = prop.GetValue(bodyModel);
                    if (value != null) prop.SetValue(command, value);
                }
            }
            
            bindingContext.Result = ModelBindingResult.Success(command);
        }
        else
        {
            bindingContext.Result = ModelBindingResult.Failed();
        }

        return Task.CompletedTask;
    }
}

2. 在命令类上标记绑定器 #

[ModelBinder(BinderType = typeof(RouteToCommandBinder))]
public class AddWorkExperienceCommand
{
    public Guid PersonId { get; set; }
    // 其他业务属性...
}

3. 简化控制器方法 #

此时控制器无需单独接收personId参数：

[HttpPost("{personId:guid}/workExperience")]
public async Task<IActionResult> AddWorkExperienceAsync(
    [FromBody] AddWorkExperienceCommand command, // 绑定器自动处理personId赋值
    [FromServices] IMediator mediator,
    CancellationToken cancellationToken)
{
    var result = await mediator.Send(command, cancellationToken);
    return Created(nameof(GetByIdAsync), result);
}

方法三：使用Action过滤器（灵活扩展） #

通过Action过滤器在模型绑定完成后，自动给命令对象赋值路由参数：

1. 实现Action过滤器 #

public class MapRouteToCommandFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context)
    {
        // 从路由提取personId
        if (context.RouteData.Values.TryGetValue("personId", out var personIdObj) 
            && Guid.TryParse(personIdObj.ToString(), out Guid personId))
        {
            // 找到命令对象并赋值
            var command = context.ActionArguments.Values
                .OfType<AddWorkExperienceCommand>()
                .FirstOrDefault();
            
            if (command != null) command.PersonId = personId;
        }
    }

    public void OnActionExecuted(ActionExecutedContext context)
    {
        // 无需额外处理
    }
}

2. 注册过滤器（Program.cs） #

builder.Services.AddScoped<MapRouteToCommandFilter>();

3. 在控制器方法上应用过滤器 #

[HttpPost("{personId:guid}/workExperience")]
[ServiceFilter(typeof(MapRouteToCommandFilter))]
public async Task<IActionResult> AddWorkExperienceAsync(
    [FromBody] AddWorkExperienceCommand command,
    [FromServices] IMediator mediator,
    CancellationToken cancellationToken)
{
    var result = await mediator.Send(command, cancellationToken);
    return Created(nameof(GetByIdAsync), result);
}

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