Razor Pages模型数据注解客户端验证未生效问题排查

你遇到的[Required]、[StringLength]、[RegularExpression]不生效的问题，核心原因是客户端验证依赖的脚本未引入，或者视图没有正确生成验证标记——[DisplayName]这类属性只负责渲染标签文本，不需要验证框架支持，所以能正常生效。

以下是具体解决步骤：

• 引入客户端验证必备脚本
  在注册页面的布局文件（_Layout.cshtml）或当前视图的末尾，按顺序引入三个关键脚本：

  <script src="~/lib/jquery/dist/jquery.min.js"></script>
  <script src="~/lib/jquery-validation/dist/jquery.validate.min.js"></script>
  <script src="~/lib/jquery-validation-unobtrusive/jquery.validate.unobtrusive.min.js"></script>
  

  注意脚本顺序不能颠倒，jQuery必须在最前面。

• 使用Tag Helper绑定模型字段
  视图中必须用asp-for属性生成表单控件，Razor会自动添加验证所需的data-*属性，同时保留asp-validation-for显示错误提示：

  <div class="form-group">
      <label asp-for="CoreUser.UserName"></label>
      <input asp-for="CoreUser.UserName" class="form-control" />
      <span asp-validation-for="CoreUser.UserName" class="text-danger"></span>
  </div>
  

  不要手动编写name属性，否则无法触发客户端验证。

• 确认项目启用非侵入式验证
  在Program.cs（.NET 6+）中，确保Razor Pages配置未禁用验证：

  builder.Services.AddRazorPages();
  

  默认配置已启用客户端非侵入式验证，如果之前手动修改过配置，需添加以下内容恢复：

  builder.Services.AddRazorPages()
      .AddMvcOptions(options =>
      {
          options.ClientValidationEnabled = true;
          options.UnobtrusiveJavaScriptEnabled = true;
      });
  

  老版本（.NET 5及之前）在Startup.cs的ConfigureServices方法中做同样配置。

• 服务器端验证兜底
  即使客户端验证生效，也要在PageModel的Post方法中检查ModelState.IsValid，避免恶意请求：

  public async Task<IActionResult> OnPostAsync()
  {
      if (!ModelState.IsValid)
      {
          return Page();
      }
      // 执行用户信息保存逻辑
      return RedirectToPage("/Index");
  }
  

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