ASP.NET Core Web API中[FromBody]参数的[Required]属性验证未生效问题

我来帮你分析这个问题的核心原因，以及对应的解决办法：

问题的核心原因 #

1. 非可空值类型的[Required]属性天然不触发验证失败 #

你的SomeState是int类型（非可空值类型），ASP.NET Core的模型绑定系统在处理JSON请求时，如果你没有传入这个字段，会自动给它赋值默认值0，而非让它处于未初始化状态。对于非可空值类型来说，即使添加了[Required]属性（来自System.ComponentModel.DataAnnotations），也不会触发验证失败——因为值类型永远不会为null，模型验证系统会默认认为这个字段始终有有效值。

2. 自动生成代码可能使用了不被模型验证识别的[Required]属性 #

你代码里自动生成的[Required]属性，大概率来自System.Runtime.Serialization命名空间（和[DataMember]、[DataContract]配套的序列化属性），而非ASP.NET Core模型验证系统默认识别的System.ComponentModel.DataAnnotations.RequiredAttribute。这两个属性是完全独立的：

• System.Runtime.Serialization.RequiredAttribute仅用于控制序列化/反序列化行为，告诉序列化器这个字段必须存在才能完成序列化；
• 只有System.ComponentModel.DataAnnotations.RequiredAttribute才会被ASP.NET Core的模型验证系统识别，用于判断ModelState是否有效。

如果自动生成的代码用的是前者，模型验证系统完全不会把这个字段标记为“必填”，自然不会返回BadRequest。

对应的解决办法 #

根据你代码自动生成的场景（基于TypeSpec/OpenAPI），可以按以下优先级尝试解决：

方法一：调整上游定义，生成可空值类型+正确的[Required]属性 #

既然代码是自动生成的，最根本的解决方式是修改上游的TypeSpec/OpenAPI定义：

• 把someState字段的类型设置为integer且nullable: true，同时保留required: true标记；
• 这样OpenAPI Generator会生成int?类型的SomeState属性，并且如果配置正确，会使用System.ComponentModel.DataAnnotations.RequiredAttribute。

当SomeState是int?时，如果JSON里没传这个字段，它会被绑定为null，此时[Required]属性会触发验证失败，ModelState.IsValid会变为false，API会自动返回BadRequest。

方法二：让ASP.NET Core识别System.Runtime.Serialization.RequiredAttribute #

如果你没办法修改上游定义，可以在ASP.NET Core项目中添加对System.Runtime.Serialization.RequiredAttribute的验证支持。通过自定义模型验证提供者实现：

builder.Services.AddControllers()
    .AddMvcOptions(options =>
    {
        options.ModelValidatorProviders.Add(new DataContractRequiredValidatorProvider());
    });

// 自定义验证提供者，识别DataContract下的Required属性
public class DataContractRequiredValidatorProvider : IModelValidatorProvider
{
    public void CreateValidators(ModelValidatorProviderContext context)
    {
        // 检查当前属性所属的类是否标记了DataContract
        if (context.ModelMetadata.ContainerType?.GetCustomAttributes(typeof(DataContractAttribute), true).Any() == true)
        {
            var propertyInfo = context.ModelMetadata.PropertyGetter?.Target as PropertyInfo;
            // 检查当前属性是否标记了System.Runtime.Serialization.RequiredAttribute
            if (propertyInfo?.GetCustomAttributes(typeof(RequiredAttribute), true).Any(a => a is System.Runtime.Serialization.RequiredAttribute) == true)
            {
                context.Validators.Add(new DataContractRequiredValidator());
            }
        }
    }
}

// 具体的验证逻辑
public class DataContractRequiredValidator : IModelValidator
{
    public IEnumerable<ModelValidationResult> Validate(ModelValidationContext context)
    {
        if (context.Model == null)
        {
            yield return new ModelValidationResult("", $"字段 {context.ModelMetadata.PropertyName} 是必填项。");
        }
    }
}

不过注意：这个方法对非可空值类型（比如int）依然无效，因为模型绑定会自动赋值默认值0，不会为null。所以建议配合方法一，把值类型改为可空类型使用。

方法三：手动添加验证逻辑作为兜底 #

如果以上方法都无法实施，你可以在MyMethod中手动检查嵌套属性的有效性：

public override async Task<IActionResult> MyMethod (
    [FromRoute(Name = "someString"), Required] string someString,
    [FromRoute(Name = "someInt"), Required] int someInt,
    [FromBody] MyMethodRequest myRequest)
{
    // 手动检查嵌套属性的有效性（根据你的业务逻辑调整判断条件）
    if (myRequest?.MyObject == null || myRequest.MyObject.SomeState == 0)
    {
        ModelState.AddModelError("MyObject.SomeState", "SomeState是必填项，且不能为默认值0。");
    }

    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }

    // 执行后续业务逻辑
    return Ok();
}

这种方法直接但不够灵活，一旦上游TypeSpec/OpenAPI定义变化，你需要同步修改这里的手动验证逻辑。

额外注意点 #

确保你的API控制器添加了[ApiController]属性——ASP.NET Core会自动为标记了该属性的控制器检查ModelState.IsValid，并在无效时自动返回BadRequest；如果没有这个属性，就需要你手动检查ModelState.IsValid并返回对应结果。

备注：内容来源于stack exchange，提问作者André Reichelt