.NET Core API多对多关联表单提交出现Selections必填验证错误排查

1. 非可空集合属性的隐式验证 #

你的Selections作为多对多关联的ICollection<Selection>属性，如果没有在构造函数中初始化，或者未声明为可空类型，模型绑定器会把未传递的该字段视为null。在C# 8+启用Nullable上下文后，非空引用类型会自动触发必填验证——哪怕你没加[Required]特性。

解决办法：

• 在CarForm类的构造函数中初始化集合：

  public class CarForm
  {
      public CarForm()
      {
          Selections = new List<Selection>();
      }
      // 其他属性...
      public ICollection<Selection> Selections { get; set; }
  }
  

• 或者将属性改为可空类型：

  public ICollection<Selection>? Selections { get; set; }
  

2. SelectedCheckboxes字段的传递问题 #

多选复选框的name属性必须和后端模型中的字段名完全一致，比如前端要写<input type="checkbox" name="SelectedCheckboxes" value="addonId">，否则后端无法正确绑定数组，会认为该字段缺失触发必填错误。如果允许用户不勾选任何选项，需要放宽验证规则。

解决办法：

• 核对前端复选框的name属性与后端SelectedCheckboxes字段名拼写一致；
• 如果允许空选择，将字段改为可空数组或添加允许空值的验证特性：

  public string[]? SelectedCheckboxes { get; set; }
  // 或者
  [Required(AllowEmptyStrings = true)]
  public string[] SelectedCheckboxes { get; set; }
  

3. CarModel字段的非空验证 #

如果你的CarModel是public string CarModel { get; set; }这种非可空字符串类型（启用Nullable后），即使没加[Required]，.NET Core也会自动添加必填验证，空字符串或null都会触发错误。

解决办法：

• 如果允许CarModel为空，改为可空字符串：public string? CarModel { get; set; }；
• 如果确实必填，确保前端表单中正确传递了该字段的值，没有遗漏或为空。

4. 避免直接用实体类接收请求 #

直接把Code First的实体类（如CarForm）作为API请求参数是不合理的——实体包含关联属性（Selections），而前端不会传递关联实体的完整数据，必然导致模型绑定失败。

解决办法：
创建专门的请求DTO（数据传输对象），只包含前端需要提交的字段，再映射到实体类处理：

// 请求DTO类
public class CarFormSubmitRequest
{
    [Required(ErrorMessage = "车型为必填项")] // 根据业务需求添加验证
    public string? CarModel { get; set; }
    public string[]? SelectedCheckboxes { get; set; }
    // 其他前端需要传递的字段
}

// POST接口示例
[HttpPost]
public async Task<IActionResult> SubmitCarForm([FromBody] CarFormSubmitRequest request)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }

    // 将DTO映射到实体类
    var carForm = new CarForm
    {
        CarModel = request.CarModel,
        Selections = request.SelectedCheckboxes?
            .Select(addonId => new Selection { AddonId = addonId })
            .ToList() ?? new List<Selection>()
    };

    _context.CarForms.Add(carForm);
    await _context.SaveChangesAsync();

    return Ok(carForm.Id);
}

5. 检查全局验证配置 #

确认项目中没有全局的验证过滤器或自定义模型绑定规则，强制要求这些字段必填。可以查看Program.cs/Startup.cs中的控制器配置：

builder.Services.AddControllers(options =>
{
    // 检查是否有自定义的验证过滤器
    // options.Filters.Add(...);
});

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