模型绑定无法正确映射类型，Type属性为空致ModelState无效

问题场景 #

添加新事件时，ModelState.IsValid始终返回false，调试发现AddNewEventViewModel的Type属性为null，但TypeId是有效值。

相关代码如下：

视图模型 #

public class AddNewEventViewModel
{
    [Required]
    [StringLength(20, MinimumLength = 5)]
    public string Name { get; set; } = null!;

    [Required]
    [StringLength(150, MinimumLength = 15)]
    public string Description { get; set; } = null!;
        
    [Required]
    public DateTime Start { get; set; }

    [Required]
    public DateTime End { get; set; }

    [Required]
    public int TypeId { get; set; }

    [Required]
    public Data.Models.Type Type { get; set; } = null!;

    public IEnumerable<TypeViewModel> Types { get; set; } = new List<TypeViewModel>();
}

服务层添加方法 #

public async Task AddAnEventAsync(AddNewEventViewModel model, string id)
{
    Event ev = new Event
    {
        Name = model.Name,
        Description = model.Description,
        Start = model.Start,
        End = model.End,
        Type = model.Type,
        TypeId = model.TypeId,
        CreatedOn = DateTime.Now,
        OrganiserId = id
    };

    await dbContext.Events.AddAsync(ev);
    await dbContext.SaveChangesAsync();
}

控制器代码 #

[HttpGet]
public async Task<IActionResult> Add()
{
    AddNewEventViewModel model = await this.eventService.GenerateNewAddNewEventViewModelAsync(); 
    //该方法会查询数据库获取可用类型并分配给模型的Types集合

    return View(model);
}

[HttpPost]
public async Task<IActionResult> Add(AddNewEventViewModel model)
{
    if (!ModelState.IsValid) 
    {
        return View(model);
    }

    await this.eventService.AddAnEventAsync(model, GetUserId());

    return View(nameof(All));
}

原因 #

AddNewEventViewModel中的Type属性标记了[Required]特性，但前端表单提交时只会传递TypeId（从视图的下拉框交互逻辑可知，提交的是类型ID值），而Type是复杂实体对象，ASP.NET Core默认模型绑定无法将单个ID值自动转换为完整的Type实体，导致Type为null，触发必填验证失败，最终ModelState.IsValid为false。

解决方案 #

1. 修正视图模型 #

移除Type属性上的[Required]特性，前端不需要也无法提交完整的Type实体，仅通过TypeId即可关联类型：

// 移除[Required]特性
public Data.Models.Type Type { get; set; } = null!;

2. 调整服务层逻辑 #

无需依赖视图模型中的Type对象，通过TypeId即可完成关联，有两种处理方式：

方式一：直接使用TypeId（推荐）
如果Event实体已正确配置与Type的外键关系，仅设置TypeId即可，EF Core会自动维护外键关联：

public async Task AddAnEventAsync(AddNewEventViewModel model, string id)
{
    Event ev = new Event
    {
        Name = model.Name,
        Description = model.Description,
        Start = model.Start,
        End = model.End,
        TypeId = model.TypeId, // 仅设置TypeId
        CreatedOn = DateTime.Now,
        OrganiserId = id
    };

    await dbContext.Events.AddAsync(ev);
    await dbContext.SaveChangesAsync();
}

方式二：手动查询Type实体
若需确保Type实体存在，可先查询再赋值：

public async Task AddAnEventAsync(AddNewEventViewModel model, string id)
{
    var eventType = await dbContext.Types.FindAsync(model.TypeId);
    if (eventType == null)
    {
        throw new ArgumentException("无效的类型ID");
    }

    Event ev = new Event
    {
        Name = model.Name,
        Description = model.Description,
        Start = model.Start,
        End = model.End,
        Type = eventType,
        TypeId = model.TypeId,
        CreatedOn = DateTime.Now,
        OrganiserId = id
    };

    await dbContext.Events.AddAsync(ev);
    await dbContext.SaveChangesAsync();
}

3. 可选：简化视图模型 #

如果视图仅需展示类型选项和提交TypeId，可直接从视图模型中移除Type属性，进一步精简模型：

public class AddNewEventViewModel
{
    [Required]
    [StringLength(20, MinimumLength = 5)]
    public string Name { get; set; } = null!;

    [Required]
    [StringLength(150, MinimumLength = 15)]
    public string Description { get; set; } = null!;
        
    [Required]
    public DateTime Start { get; set; }

    [Required]
    public DateTime End { get; set; }

    [Required]
    public int TypeId { get; set; }

    public IEnumerable<TypeViewModel> Types { get; set; } = new List<TypeViewModel>();
}

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