ASP.NET Core中是否有更优的必填字段验证解决方案？

针对你遇到的「必填值类型参数要么触发不了验证，要么需要手动空值检查」的问题，以下是两种场景下的具体解决方案，完全满足你的需求：

一、查询参数场景 #

直接使用[BindRequired]修饰非可空值类型参数：

[HttpGet]
public async Task<IActionResult> GetSomething([BindRequired] Guid IdOfSomething) 
{
    // 无需检查空值：未传参数会直接返回400；传了则参数必有值（包括合法的Guid.Empty）
    var result = await _service.GetById(IdOfSomething);
    return Ok(result);
}

原理 #

[BindRequired]强制要求绑定源（这里是URL查询参数）必须包含该参数：

• 客户端未传该参数：模型绑定阶段直接失败，ASP.NET Core自动返回400 Bad Request响应；
• 客户端传了00000000-0000-0000-0000-000000000000这类合法默认值：绑定成功，参数可直接使用，无需空值判断。

二、请求体模型场景 #

根据你使用的JSON序列化器，选择对应方案：

方案1：使用System.Text.Json（默认） #

用[JsonRequired]修饰非可空值类型属性：

public record PostModel
{
    [JsonRequired]
    public Guid IdOfSomething { get; init; }
}

原理 #

• 客户端JSON请求体中未包含IdOfSomething字段：System.Text.Json序列化失败，ASP.NET Core自动返回400错误；
• 客户端传了"IdOfSomething": "00000000-0000-0000-0000-000000000000"：模型绑定成功，属性值为Guid.Empty（合法值），可直接使用。

方案2：兼容多序列化器/自定义验证逻辑 #

如果需要支持Newtonsoft.Json或更灵活的验证规则，可自定义验证属性+可空类型，再封装非可空访问入口：

1. 自定义验证属性：

public class RequiredIfNotProvidedAttribute : ValidationAttribute
{
    protected override ValidationResult? IsValid(object? value, ValidationContext validationContext)
    {
        // 可空类型值为null → 客户端未提供该字段，触发验证错误
        if (value is null)
        {
            return new ValidationResult(ErrorMessage ?? $"The {validationContext.DisplayName} field is required.");
        }
        // 提供了值（包括默认值）→ 验证通过
        return ValidationResult.Success;
    }
}

2. 模型定义：

public record PostModel
{
    [RequiredIfNotProvided]
    public Guid? IdOfSomething { get; init; }

    // 验证通过后，该属性必然非空，直接使用即可
    public Guid IdOfSomethingSafe => IdOfSomething.Value;
}

3. 控制器中使用：

[HttpPost]
public async Task<IActionResult> CreateSomething([FromBody] PostModel model)
{
    // 直接使用model.IdOfSomethingSafe，无需空值检查
    var newItem = await _service.Create(model.IdOfSomethingSafe);
    return CreatedAtAction(nameof(GetSomething), new { id = newItem.Id }, newItem);
}

关键前提 #

确保你的控制器标注了[ApiController]特性，ASP.NET Core会自动处理模型验证错误并返回400响应，无需手动检查ModelState.IsValid。

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