ASP.NET Core 2.1中如何重写int/int?类型的模型状态错误信息？

你的自定义IsInt验证属性没生效，核心原因是ASP.NET Core的模型绑定阶段先于验证阶段执行：当你输入字符串abc时，系统尝试把它转换为int?类型直接失败了，这时候模型状态会直接添加绑定错误，你的自定义验证逻辑根本没机会运行——只有当绑定成功（比如输入能转成数字的字符串），验证属性才会被触发执行。

下面给你三种可行的解决办法，按推荐程度排序：

方案一：全局配置替换绑定错误消息（最简单） #

直接在Startup.cs的ConfigureServices方法里配置ApiBehaviorOptions，统一替换所有类型转换类的错误消息：

services.Configure<ApiBehaviorOptions>(options =>
{
    options.InvalidModelStateResponseFactory = context =>
    {
        var errorDict = new Dictionary<string, string[]>();
        
        foreach (var kvp in context.ModelState)
        {
            var fieldErrors = kvp.Value.Errors
                .Select(error => 
                {
                    // 判断是否是int转换错误，替换成自定义消息
                    if (error.Exception is FormatException || 
                        error.ErrorMessage.Contains("Could not convert string to integer"))
                    {
                        return "Only number is allowed";
                    }
                    // 其他错误保留原消息
                    return error.ErrorMessage;
                })
                .ToArray();
            
            if (fieldErrors.Any())
            {
                errorDict.Add(kvp.Key, fieldErrors);
            }
        }

        return new BadRequestObjectResult(errorDict);
    };
});

这个方法不需要修改现有模型和验证逻辑，全局生效，所有int/int?类型的转换错误都会被替换成你想要的提示。

方案二：将属性改为string类型，通过验证实现转换 #

如果你只想针对单个属性自定义，可以把模型属性改成string类型，然后在验证里判断是否能转成int：

1. 修改模型属性 #

public class YourModel
{
    [IsInt]
    public string StreetNo { get; set; }

    // 提供一个方便获取int?值的属性
    public int? StreetNoValue => int.TryParse(StreetNo, out var num) ? num : null;
}

2. 修正IsInt验证属性逻辑 #

public class IsInt : ValidationAttribute
{
    public override bool IsValid(object value)
    {
        var strValue = value as string;
        if (string.IsNullOrWhiteSpace(strValue))
        {
            return true; // 允许空值
        }
        return int.TryParse(strValue, out _);
    }

    protected override ValidationResult IsValid(object value, ValidationContext validationContext)
    {
        if (!IsValid(value))
        {
            return new ValidationResult("Only number is allowed");
        }
        return ValidationResult.Success;
    }
}

这种方法需要调整模型结构，但适合对特定属性做精细化控制。

方案三：自定义模型绑定器（最灵活） #

创建针对int?类型的自定义绑定器，在绑定阶段直接处理转换错误：

1. 实现模型绑定器 #

public class NullableIntModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueProviderResult == ValueProviderResult.None)
        {
            return Task.CompletedTask;
        }

        bindingContext.ModelState.SetModelValue(bindingContext.ModelName, valueProviderResult);
        var inputValue = valueProviderResult.FirstValue;

        if (string.IsNullOrWhiteSpace(inputValue))
        {
            bindingContext.Result = ModelBindingResult.Success(null);
            return Task.CompletedTask;
        }

        if (int.TryParse(inputValue, out var result))
        {
            bindingContext.Result = ModelBindingResult.Success(result);
        }
        else
        {
            // 添加自定义错误消息
            bindingContext.ModelState.AddModelError(bindingContext.ModelName, "Only number is allowed");
            bindingContext.Result = ModelBindingResult.Failed();
        }

        return Task.CompletedTask;
    }
}

2. 注册绑定器 #

可以针对单个属性注册：

[ModelBinder(BinderType = typeof(NullableIntModelBinder))]
public int? StreetNo { get; set; }

或者全局注册，让所有int?类型都使用这个绑定器：

services.AddMvc(options =>
{
    options.ModelBinderProviders.Insert(0, new BinderTypeModelBinderProvider(typeof(NullableIntModelBinder)));
});

这种方法灵活性最高，适合需要对绑定逻辑做深度定制的场景。

当你输入83444时，系统能成功把字符串转成int?，绑定阶段通过，这时候才会触发你的IsInt验证属性——而你的验证逻辑里只要值是int?类型就返回true，所以验证通过，不会返回错误。但输入abc时绑定直接失败，验证根本没机会运行，所以你看到的还是系统默认的绑定错误。

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