Angular(v15)向ASP.NET MVC(.NET4.72)POST数据时对象属性为NULL

1. 请求数据结构与后端参数绑定不匹配 #

你前端把Queue对象嵌套在queue键下发送（JSON结构为{"queue": {...}}），但后端直接接收Queue类型参数。ASP.NET MVC的模型绑定默认会从请求体的顶层属性匹配参数，不会自动解析嵌套的queue键，导致除了可能通过其他方式传入的QueueId外，其余属性无法绑定。

解决方法二选一：

• 前端调整：去掉外层的queue键，直接发送Queue对象的JSON，比如：

  // Angular代码示例
  const queueData = { queueId: 1, customerFullName: "张三", status: "Waiting" };
  this.http.post('/api/queue/add', queueData).subscribe(...);
  

• 后端调整：使用包装类或者指定绑定前缀：
  • 方式一：创建包装类接收嵌套结构

    public class QueueRequest
    {
        public Queue Queue { get; set; }
    }
    
    [HttpPost]
    public ActionResult AddQueue([FromBody] QueueRequest request)
    {
        var queue = request.Queue;
        // 处理逻辑
    }
    

  • 方式二：给参数添加[Bind(Prefix="queue")]特性

    [HttpPost]
    public ActionResult AddQueue([FromBody][Bind(Prefix="queue")] Queue queue)
    {
        // 处理逻辑
    }
    

2. 缺少[FromBody]特性 #

在.NET Framework的ASP.NET MVC中，POST请求的复杂类型参数必须添加[FromBody]特性，否则模型绑定会尝试从URL参数、表单数据中获取值，而非请求体的JSON。如果QueueId是通过URL传入的（比如/api/queue/add?queueId=1），就会只有QueueId有值，其他属性为null。

修正后的后端方法：

[HttpPost]
public ActionResult AddQueue([FromBody] Queue queue)
{
    // 处理逻辑
}

3. 前后端属性名称/序列化配置不匹配 #

Angular默认会将类属性序列化为驼峰式（比如customerFullName），而后端Queue类的属性是帕斯卡式（比如CustomerFullName）。虽然ASP.NET MVC默认支持驼峰到帕斯卡的映射，但如果后端序列化配置被修改，或者属性名称拼写不一致（比如前端是customerName，后端是CustomerFullName），也会导致绑定失败。

解决方法：

• 确保前后端属性名称拼写完全一致（忽略大小写的映射默认生效）；
• 若需要严格匹配，可在后端属性上添加[JsonProperty]特性指定对应JSON键名：

  public class Queue
  {
      public int QueueId { get; set; }
      [JsonProperty("customerFullName")]
      public string CustomerFullName { get; set; }
      [JsonProperty("status")]
      public string Status { get; set; }
  }
  

4. 后端Queue类属性无公共setter #

如果后端Queue类的属性只有getter没有公共setter，模型绑定无法为属性赋值，导致属性为null。比如：

// 错误示例
public class Queue
{
    public int QueueId { get; }
    public string CustomerFullName { get; }
}

需要改为带有公共setter的属性：

// 正确示例
public class Queue
{
    public int QueueId { get; set; }
    public string CustomerFullName { get; set; }
    public string Status { get; set; }
}

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