POST请求[FromBody]参数内[FromRoute]属性绑定为null问题求解

问题原因 #

ASP.NET Core的模型绑定有明确的绑定源优先级规则：

1. 当参数显式标注[FromBody]时，框架会直接使用对应请求格式化器（如JSON、XML格式化器）读取整个请求体来绑定参数对象，此时会完全忽略参数类型内部属性上标注的[FromRoute]/[FromQuery]等其他绑定源特性，只会从请求体中匹配对应字段。你场景里的userId存在于路由数据中，请求体没有对应字段，自然无法绑定到UserId属性，值为null。
2. 当参数标注[FromQuery]时，模型绑定会启用多源扫描逻辑，会逐个识别属性上标注的绑定源特性，除了从查询字符串取值外，也会从路由、表单等其他源匹配对应值，所以UserId可以正常从路由获取。
3. 未指定参数绑定源时，ASP.NET Core对POST请求的复杂类型参数会默认推断为[FromBody]，所以和显式标注[FromBody]表现一致，UserId依然为null。

无需自定义模型绑定器的解决方案 #

方案1：拆分参数（兼容性最高，全版本适用） #

把路由值和请求体参数分开定义，业务层自行组装对象即可，改动最小：

[HttpPost]    
[Route("{userId}/orders/add")]
public async Task<ActionResult<UserOrderCreationRequest>> CreateOrder(
           [FromRoute] string userId,
           [FromBody] Order order)
{
    var request = new RequestObject
    {
        UserId = userId,
        Order = order
    };
    // 后续业务逻辑
}

方案2：使用[AsParameters]特性（适用于ASP.NET Core 7+版本） #

不需要拆分接口参数，只要给参数加[AsParameters]，同时给请求体对应的属性加[FromBody]即可自动识别混合绑定源：
接口代码：

[HttpPost]    
[Route("{userId}/orders/add")]
public async Task<ActionResult<UserOrderCreationRequest>> CreateOrder(
           [AsParameters] RequestObject request)

调整RequestObject定义：

public class RequestObject
{
    [FromRoute(Name = "userId")]
    public string UserId { get; set; }

    [FromBody]
    public Order Order { get; set; }
}

方案3：手动读取路由值赋值（零结构改动，全版本适用） #

如果不方便调整现有参数和模型结构，直接在Action逻辑开头从HttpContext读取路由值赋值即可：

[HttpPost]    
[Route("{userId}/orders/add")]
public async Task<ActionResult<UserOrderCreationRequest>> CreateOrder(
           [FromBody] RequestObject request)
{
    request.UserId = HttpContext.Request.RouteValues["userId"]?.ToString();
    // 后续业务逻辑
}

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