.NET 4.7.2升级.NET6后ModelState.IsValid验证范围异常求助

将项目从.NET 4.7.2升级至.NET 6后，模型验证从System.Web.Mvc切换为Microsoft.AspNetCore.Mvc.ModelBinding。目前用户无法进入支付页面，核心问题是PaymentController中的ModelState.IsValid会同时验证PaymentViewModel以及继承自同一基类CViewModel的无关ViewModel对应实体的必填字段，而升级前仅验证PaymentViewModel本身。相关控制器、ViewModel及模型代码未改动，新增其他类属性未复现该问题。

代码示例 #

public class CViewModel<TPage> : ICViewModel<TPage> 
    where TPage : IContent
{
    public TPage CurrentPage { get; set; }
    public Core.Models.Pages.UnrelatedPage UnrelatedPage { get; set; }
    public GlobalSettingsPage GlobalSettings { get; set; }
}

public class PaymentViewModel : CViewModel<Core.Models.Pages.PaymentPage>, IPaymentViewModel    
{
}

public class UnrelatedViewModel : CViewModel<Core.Models.Pages.UnrelatedPage>
{
}

public class PaymentController : BasePageController<Core.Models.Pages.PaymentPage, PaymentViewModel>
{
    public async Task<ActionResult> Index(Core.Models.Pages.PaymentPage currentPage)
    {       
        if (!ModelState.IsValid)
        {
            ViewModel.IsEditPage = true;
            return View("/Features/PaymentPage/Index.cshtml", ViewModel);
        }

        return View("/Features/PaymentPage/Payment.cshtml", ViewModel);
    }            
}

public abstract class BasePageController<TPage, TViewModel> : BaseAnyContentController<TPage, TViewModel>
    where TPage : PageData
    where TViewModel : ContentViewModel<TPage>, new()
{
}

问题根源 #

ASP.NET Core的模型验证逻辑和.NET Framework下的ASP.NET MVC存在差异：

• 旧版ASP.NET MVC默认仅验证当前Action绑定的直接模型对象；
• ASP.NET Core会递归验证模型的所有属性（包括基类中的嵌套对象），如果UnrelatedPage、GlobalSettings这类嵌套对象带有[Required]等验证特性，就会被纳入验证范围，导致ModelState.IsValid返回false。

排查步骤 #

1. 检查UnrelatedPage和GlobalSettings类的定义，确认是否带有[Required]或其他强制验证特性；
2. 调试时查看ModelState.Errors集合，定位具体触发错误的字段，确认是否来自无关实体类。

解决办法 #

1. 标记跳过特定属性验证 #

在PaymentViewModel中重写基类的无关属性，用[ValidateNever]标记，告知验证系统跳过这些属性的校验：

public class PaymentViewModel : CViewModel<Core.Models.Pages.PaymentPage>, IPaymentViewModel    
{
    [ValidateNever]
    public override Core.Models.Pages.UnrelatedPage UnrelatedPage { get; set; }

    [ValidateNever]
    public override GlobalSettingsPage GlobalSettings { get; set; }
}

2. 手动清理ModelState错误 #

在Action验证前，手动移除无关字段的验证错误：

public async Task<ActionResult> Index(Core.Models.Pages.PaymentPage currentPage)
{       
    // 移除无关属性的验证错误项
    ModelState.Remove(nameof(ViewModel.UnrelatedPage));
    ModelState.Remove(nameof(ViewModel.GlobalSettings));

    if (!ModelState.IsValid)
    {
        ViewModel.IsEditPage = true;
        return View("/Features/PaymentPage/Index.cshtml", ViewModel);
    }

    return View("/Features/PaymentPage/Payment.cshtml", ViewModel);
}            

3. 重构基类设计 #

如果多个ViewModel都存在类似问题，可以拆分CViewModel，将不需要全局验证的属性抽离到单独的接口或类中，避免不必要的验证逻辑继承。

4. 自定义验证过滤器 #

创建自定义ActionFilterAttribute，在验证阶段自动过滤掉不需要校验的属性或类型，实现全局范围的验证规则控制。

内容的提问来源于stack exchange，提问作者Emilija Vilija Trečiokaitė