ModelState.IsValid在Required属性合法时仍返回False如何解决

即使带有[Required]注解的属性已传入合法值，ModelState.IsValid仍返回false。通过日志记录对象的字符串表示，可确认Username和Password字段均不为空。

User模型定义 #

public class User
{
    public int Id { get; set; }

    [Required]
    public string Username { get; set; }

    [Required]
    [DataType(DataType.Password)]
    public string Password { get; set; }

    [DataType(DataType.EmailAddress)]
    public string Email { get; set; }

    public override string ToString()
    {
         return $"Username: {Username}, Password: {Password}";
    }
}

AuthController控制器代码 #

public class AuthController : Controller
{
    private readonly UserContext _context;
    private readonly ILogger<User> _logger;
    [BindProperty]
    public User AuthUser { get; set; }

    public AuthController(ILogger<User> logger, UserContext context)
    {
        _logger = logger;
        _context = context;
    }
    public IActionResult Login()
    {
        return View(new User());
    }
    [HttpPost]
    public async Task<IActionResult> Login(string returnURL = null)
    {
        if (!ModelState.IsValid) 
        {
             _logger.LogInformation(AuthUser.ToString());
             // 即使Username和Password字段有值仍会进入此代码块
        }
    }
}

异常表现 #

POST提交Login请求时，即使传入的AuthUser对象中Username、Password两个必填字段均有有效值，仍无法通过ModelState校验，直接进入校验失败的逻辑分支。

按以下步骤定位问题即可：

• 第一步先打印全量ModelState错误，不要只靠对象日志判断。在!ModelState.IsValid分支内加入遍历代码，直接输出所有触发校验失败的字段和具体原因，绝大多数场景可以直接定位根因：

if (!ModelState.IsValid) 
{
    foreach (var key in ModelState.Keys)
    {
        var state = ModelState[key];
        foreach (var err in state.Errors)
        {
            _logger.LogInformation("校验失败字段：{Field}，错误信息：{Msg}，关联异常：{Ex}", 
                key, err.ErrorMessage, err.Exception?.Message);
        }
    }
    _logger.LogInformation(AuthUser.ToString());
}

• 最高发的根因是非可空引用类型的隐式校验规则：如果你的项目在.csproj中开启了<Nullable>enable</Nullable>配置，ASP.NET Core会自动给所有未标记为可空的引用类型追加隐式[Required]校验。你的User模型中Email字段是string类型（没有加?标记为可空），即使你没手动加[Required]，只要提交时Email为空，就会触发校验失败，和Username、Password是否传值无关。
  对应修复方式二选一：
  • 可选字段显式标记为可空：将Email属性改为public string? Email { get; set; }
  • 全局关闭隐式必填校验，在Program.cs中添加配置：

    builder.Services.AddControllersWithViews(options =>
    {
        options.SuppressImplicitRequiredAttributeForNonNullableReferenceTypes = true;
    });
    

• 检查表单字段名与绑定规则是否匹配：你使用了Controller级别的[BindProperty]标记AuthUser属性，Post表单中所有User相关的输入框name属性必须加AuthUser.前缀（例如AuthUser.Username、AuthUser.Password），如果name直接写为Username，会出现部分字段绑定异常，异常会计入ModelState导致校验失败。
• 检查是否存在类型绑定错误：例如提交的字段值和模型属性类型不匹配（比如给int类型的Id传了非数字字符串），这类绑定错误会直接被计入ModelState，和必填校验无关。
• 排查是否有全局动作过滤器、自定义校验逻辑在Action执行前向ModelState中追加了错误。

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