启用可空引用后Web API模型绑定Required验证异常排查

首先明确：这不是.NET Core的bug，而是启用可空引用类型（NRT）后，ASP.NET Core模型验证的预期行为（在早期版本中存在设计局限）。你遇到的核心问题是：启用NRT后，框架自动将可空引用类型的属性也纳入了必填验证，但你只想把NRT作为代码级的警告工具，不想影响接口的请求验证逻辑。

为什么会出现这个错误？ #

• 在.NET Core 3.x中，启用NRT后，模型验证系统会将**所有引用类型（包括可空引用类型，比如string?）**默认标记为必填，这是早期版本的设计局限。
• 在.NET 5+版本中，框架修复了这个问题：仅会将非可空引用类型自动标记为[Required]，但如果未修改默认配置，部分场景下仍可能出现不符合预期的验证行为。

你的场景中，当客户端提交了filter对象（哪怕只包含部分属性），模型绑定器会实例化UserFilter，此时框架错误地将q（string?）视为必填项，导致400错误。

解决方案 #

方案1：全局禁用NRT驱动的自动验证（推荐） #

如果你希望完全隔离NRT的代码警告功能和接口的模型验证逻辑，可以全局配置关闭框架基于NRT自动生成的验证规则。

.NET 6+（顶级语句）

在Program.cs中修改控制器服务配置：

builder.Services.AddControllers()
    .AddMvcOptions(options =>
    {
        // 让NRT仅作为代码警告，不影响模型验证
        options.SuppressImplicitRequiredAttributeForNonNullableReferenceTypes = true;
    });

.NET Core 3.x / .NET 5

在Startup.cs的ConfigureServices方法中配置：

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers(options =>
    {
        options.SuppressImplicitRequiredAttributeForNonNullableReferenceTypes = true;
    });
}

这个配置会让ASP.NET Core回到传统的模型验证逻辑：只有显式标记[Required]的属性才会被视为必填，完全忽略NRT的类型标记。

方案2：局部标记属性为可选（按需使用） #

如果你不想全局修改配置，也可以针对特定属性显式取消必填验证。比如在SearchFilter的q属性上添加[Required(AllowNull = true)]，明确告诉框架允许该属性为null：

public class SearchFilter {
    [Required(AllowNull = true)]
    public string? q { get; set; }
    [Required(AllowNull = true)]
    public bool? fullResults { get; set; }
}

不过这种方式需要逐个属性添加，适合仅需调整少数属性的场景。

额外建议 #

如果你的项目还在使用.NET Core 3.x，建议升级到.NET 5+版本，不仅能修复这个NRT验证的问题，还能获得更多框架特性和性能提升。

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