ASP.NET Core Razor页面如何校验1-2字母加4位数字格式用户名

合法格式要求：1-2个英文字母开头，后接4位数字，总长度5-6位，例：b4321、ba4321。

实现分三层，覆盖前端体验、模型绑定校验、后端防绕过三个环节，全部是Razor页面原生支持的方案，不需要引入第三方组件。

1. 模型层数据注解校验（核心校验规则） #

直接在绑定的PageModel属性上加正则校验特性，模型绑定时会自动触发，是所有校验的基础：

using System.ComponentModel.DataAnnotations;
using System.Text.RegularExpressions;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;

public class RegisterModel : PageModel
{
    [Required(ErrorMessage = "用户名不能为空")]
    [RegularExpression(
        pattern: @"^[A-Za-z]{1,2}\d{4}$", 
        ErrorMessage = "用户名格式错误，需为1-2个英文字母后接4位数字，例如b4321、ba4321")]
    [Display(Name = "用户名")]
    public string UserName { get; set; }

    public void OnGet(){}
    public IActionResult OnPost()
    {
        // 自动触发所有数据注解校验，不通过直接返回页面展示错误
        if (!ModelState.IsValid)
        {
            return Page();
        }
        // 后续用户创建等业务逻辑
        return Redirect("/");
    }
}

正则说明：

• ^ 匹配字符串起始位置
• [A-Za-z]{1,2} 匹配1到2位大小写英文字母
• \d{4} 匹配4位0-9数字
• $ 匹配字符串结束位置，避免出现多余字符

2. 前端即时校验（优化输入体验） #

Razor页面默认集成了jQuery Unobtrusive Validation，只要用内置Tag Helper生成表单输入控件，模型层的校验规则会自动映射到前端，不需要单独写JS校验逻辑：

<form method="post">
    <div class="mb-3">
        <label asp-for="UserName" class="form-label"></label>
        <input asp-for="UserName" class="form-control" />
        <span asp-validation-for="UserName" class="text-danger"></span>
    </div>
    <button type="submit" class="btn btn-primary">提交</button>
</form>

如果要进一步减少无效输入，可以给输入框加实时过滤规则，只允许输入字母数字，且限制最大长度为6（最长合法长度为2字母+4数字）：

<input asp-for="UserName" class="form-control" 
       oninput="this.value = this.value.replace(/[^A-Za-z0-9]/g,'').slice(0,6)" />

3. 后端兜底校验（防恶意绕过） #

前端校验可以被禁用JS、直接构造POST请求等方式绕过，所以业务逻辑执行前可以再加一次显式正则校验，和模型层规则保持一致即可：

public IActionResult OnPost()
{
    if (!ModelState.IsValid)
    {
        return Page();
    }

    // 兜底校验，双重确认格式
    var formatValid = Regex.IsMatch(UserName, @"^[A-Za-z]{1,2}\d{4}$");
    if (!formatValid)
    {
        ModelState.AddModelError(nameof(UserName), "用户名格式不符合规则");
        return Page();
    }

    // 执行业务逻辑
    return RedirectToPage("Success");
}

校验参考示例 #

• 合法值：c1234、xy9876、Ab0001
• 非法值：abc123（3个开头字母）、a123（仅3位数字）、1ab123（数字开头）、ab123x（结尾为字母）、ab12345（数字超4位）

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