.NET Core 6中如何结合FromBody与FromHeader绑定请求数据

API 探路者

2026-6-23

实现方案

针对你的需求，有两种简单直接的实现方式，无需复杂自定义逻辑：

方式一：在模型属性上指定绑定源

直接在RegisterCustomerRequest模型的TenantId属性上添加[FromHeader]特性，让ASP.NET Core从请求头绑定该字段，其余字段默认从请求体获取：

public class RegisterCustomerRequest
{
    public int Code { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
    
    // 若请求头名称与属性名一致，可省略Name参数；如果是自定义头（如X-TenantId），需指定Name
    [FromHeader(Name = "TenantId")]
    public int TenantId { get; set; }
}

控制器方法无需修改，保持原有写法即可：

public async Task<IActionResult> RegisterCustomer(RegisterCustomerRequest model)
{
    // 业务逻辑执行时，model.TenantId已从请求头绑定完成
}

方式二：拆分参数绑定（不修改原模型）

如果不想改动原模型，可以将TenantId作为单独参数用[FromHeader]标记，其余字段用[FromBody]绑定到原模型，最后在方法内合并数据：

// 原模型保持不变
public class RegisterCustomerRequest
{
    public int Code { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
    public int TenantId { get; set; }
}

// 控制器方法修改为拆分参数形式
public async Task<IActionResult> RegisterCustomer(
    [FromBody] RegisterCustomerRequest bodyModel,
    [FromHeader(Name = "TenantId")] int tenantId)
{
    // 将请求头获取的TenantId赋值给模型
    bodyModel.TenantId = tenantId;
    
    // 执行业务逻辑
}