ASP.NET 6创建RoleHasMenu时ModelState绑定失败校验不通过问题

问题背景 #

实现角色-菜单关联权限分配功能时，提交创建Role_has_menu表关联记录的请求后，接口内ModelState.IsValid始终返回false，数据无法正常入库。
相同业务逻辑代码在过往SQL Server环境项目中可正常运行，本次项目技术栈为Visual Studio + EF6 + MySQL。

当前提交接口代码 #

[HttpPost]
[ValidateAntiForgeryToken]
public async Task<IActionResult> Create([Bind("ID,MenuID,RoleID")] RoleHasMenu roleHasMenu)
{
  if (ModelState.IsValid)
  {
     _context.Add(roleHasMenu);
     await _context.SaveChangesAsync();
     return RedirectToAction(nameof(Index));
  }

  ViewData["MenuID"] = new SelectList(_context.Menu, "ID", "FullName", roleHasMenu.MenuID);
  ViewData["RoleID"] = new SelectList(_context.Role, "ID", "Name", roleHasMenu.RoleID);
  return View(roleHasMenu);
}

报错参考 #

排查方向与解决方案 #

按优先级从高到低排查：

• 主键配置冲突
  检查RoleHasMenu实体与MySQL表结构的主键配置：
  1. 如果关联表使用MenuID+RoleID作为联合主键，Bind特性中额外包含的ID字段属于冗余字段，提交时ID无有效值会直接触发非空验证失败，移除Bind列表中的ID属性即可。
  2. 如果使用独立ID作为主键，确认MySQL表中ID字段已配置自增属性，EF6映射MySQL时（尤其是使用MySql.Data.EntityFramework包），未显式标记自增特性会导致EF判定ID为用户必填项，空值触发验证失败。
• 导航属性验证干扰
  检查RoleHasMenu实体是否定义了Menu、Role类型的导航属性。EF模型验证会扫描实体所有带非空约束的属性，即使Bind特性只绑定三个字段，未赋值的非空导航属性也会导致ModelState校验失败。
  处理方案：要么使用独立的请求ViewModel替代EF实体接收提交参数，要么在验证前手动清除导航属性的验证状态，代码如下：

  // 加在ModelState.IsValid判断前
  ModelState.Remove("Menu");
  ModelState.Remove("Role");
  

• 类型映射不匹配
  核对MySQL表字段与C#实体属性的类型对应关系：重点检查MenuID、RoleID是否存在类型不一致（比如MySQL是bigint unsigned但C#实体定义为int/有符号类型），类型不匹配会导致值绑定失败，直接标记ModelState无效。
• 提交参数合法性校验
  打开浏览器开发者工具查看请求Form Data，确认提交的MenuID、RoleID均为合法数字值、无空值/非数字内容，同时确认防伪令牌__RequestVerificationToken正常提交未过期。

最佳实践：不要直接用EF实体作为Post请求的绑定参数，使用专属ViewModel接收表单数据，完成校验后再映射为实体类写入数据库，可彻底规避无关属性验证、字段过多泄露等问题。

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