ASP.NET Core Web API POST方法报RuntimeBinderException异常如何解决？

云原生阿岚

2026-7-24

解决ASP.NET Core Web API POST方法的RuntimeBinderException异常

问题原因

你使用dynamic类型作为[FromBody]参数，EF Core无法处理dynamic类型的对象。EF Core依赖编译时明确的强类型信息来识别实体属性、构建数据库映射关系，而dynamic是运行时解析类型，导致EF无法正确绑定实体，触发Microsoft.CSharp.RuntimeBinder.RuntimeBinderException。

解决方案

1. 使用强类型实体替代dynamic

首先确保你有对应数据库表的强类型实体类，比如：

public class Employee
{
    public Guid Id { get; set; }
    // 其他与数据库表字段对应的属性
    public string Name { get; set; }
    public int Age { get; set; }
    public string Department { get; set; }
}

2. 修改控制器方法参数类型

把dynamic替换为强类型Employee，EF就能正确识别并处理实体：

[HttpPost]
public async Task<IActionResult> AddEmployee([FromBody] Employee employeeRequest)
{
    employeeRequest.Id = Guid.NewGuid();
    await _fullStackDbContext.Employees.AddAsync(employeeRequest);
    await _fullStackDbContext.SaveChangesAsync();
    return Ok(employeeRequest);
}

3. （可选）用DTO做参数解耦与校验

如果不想直接暴露实体类给前端，可以定义DTO（数据传输对象），再映射到实体：

// 定义EmployeeDTO
public class EmployeeDTO
{
    public string Name { get; set; }
    public int Age { get; set; }
    public string Department { get; set; }
}

// 修改控制器方法
[HttpPost]
public async Task<IActionResult> AddEmployee([FromBody] EmployeeDTO employeeDto)
{
    var employee = new Employee
    {
        Id = Guid.NewGuid(),
        Name = employeeDto.Name,
        Age = employeeDto.Age,
        Department = employeeDto.Department
    };
    await _fullStackDbContext.Employees.AddAsync(employee);
    await _fullStackDbContext.SaveChangesAsync();
    return Ok(employee);
}