ASP.NET中如何从请求体获取devId？使用[FromBody]仍被识别为查询参数

核心原因 #

在ASP.NET Core中，[FromBody]特性仅能绑定一个参数——因为请求体只能被读取一次。当你给Module参数标记[FromBody]后，框架会将整个请求体绑定到这个复杂类型上，剩余的简单类型参数（比如long devId）会默认从查询字符串、路由或表单数据中查找，这就是它被识别为查询参数的原因。

可行解决方案 #

方案一：将devId整合进Module类 #

如果devId属于Module资源的一部分，直接在Module类中添加对应的字段/属性：

public class Module
{
    // 原有属性
    public long Id { get; set; }
    public string Name { get; set; }
    // 添加devId属性
    public long DevId { get; set; }
}

// 控制器方法简化为
public async Task<ActionResult<Module>> PostModule([FromBody]Module module)
{
    // 直接通过module.DevId获取值
    var targetDevId = module.DevId;
    // 后续业务逻辑
}

此时请求体只需包含Module的完整结构，比如JSON格式：

{
    "id": 1,
    "name": "TestModule",
    "devId": 12345
}

方案二：创建复合模型绑定整个请求体 #

如果不想修改原有Module类，可以定义一个包含Module和devId的复合模型：

public class ModuleWithDevId
{
    public Module Module { get; set; }
    public long DevId { get; set; }
}

// 控制器方法绑定复合模型
public async Task<ActionResult<Module>> PostModule([FromBody]ModuleWithDevId model)
{
    var moduleData = model.Module;
    var targetDevId = model.DevId;
    // 后续业务逻辑
}

对应的请求体结构需要匹配复合模型：

{
    "module": {
        "id": 1,
        "name": "TestModule"
    },
    "devId": 12345
}

方案三：手动读取并解析请求体 #

如果需要更灵活的处理逻辑，可以手动读取整个请求体内容，自行解析所需数据：

using System.Text.Json;

public async Task<ActionResult<Module>> PostModule()
{
    using var streamReader = new StreamReader(Request.Body);
    var requestBody = await streamReader.ReadToEndAsync();
    var jsonDocument = JsonDocument.Parse(requestBody);
    
    // 解析devId
    var targetDevId = jsonDocument.RootElement.GetProperty("devId").GetInt64();
    // 解析Module对象
    var moduleData = jsonDocument.RootElement.GetProperty("module").Deserialize<Module>();
    
    // 后续业务逻辑
}

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