ASP.NET Core 3.1模型绑定器自定义错误消息不生效问题

问题根源 #

当输入含空格的内容（如2 0 0 0）时，ASP.NET Core的模型绑定阶段会优先尝试将字符串转换为decimal?类型，转换失败后直接添加默认的类型不匹配错误消息，此时自定义的ValidDecimalAttribute根本没机会执行，所以你看不到自定义错误。

解决方案 #

方案1：修改属性类型为string（简单直接）

将属性类型改为string，让模型绑定不会失败，确保自定义验证特性能触发，同时在验证时清理空格后再解析：

1. 修改实体类属性：

[BindProperty]
[Required(ErrorMessage = "Enter the valid amount")]
[ValidDecimal(ErrorMessage = "Enter the amount correctly")]
public string? QuoteAmountTotal { get; set; }

// 可选：添加转换后的decimal属性供业务逻辑使用
public decimal? QuoteAmountTotalValue 
{ 
    get 
    {
        if (string.IsNullOrWhiteSpace(QuoteAmountTotal))
            return null;
        return decimal.TryParse(QuoteAmountTotal.Replace(" ", ""), out var result) ? result : null;
    } 
}

2. 更新自定义验证特性，先清理空格再验证：

[AttributeUsage(AttributeTargets.Field | AttributeTargets.Property, AllowMultiple = false)]
public class ValidDecimalAttribute : ValidationAttribute
{
    protected override ValidationResult? IsValid(object? value, ValidationContext validationContext)
    {
        if (value == null || string.IsNullOrWhiteSpace(value.ToString()))
        {
            return ValidationResult.Success;
        }

        // 移除所有空格后再尝试解析
        var cleanedInput = value.ToString()?.Replace(" ", "");
        return decimal.TryParse(cleanedInput, out _) 
            ? ValidationResult.Success 
            : new ValidationResult(ErrorMessage);
    }
}

方案2：自定义模型绑定器（全局适配）

通过自定义模型绑定器接管decimal?类型的绑定逻辑，在转换失败时替换默认错误消息，无需修改属性类型：

1. 创建自定义模型绑定器：

public class DecimalModelBinder : IModelBinder
{
    public Task BindModelAsync(ModelBindingContext bindingContext)
    {
        if (bindingContext == null)
            throw new ArgumentNullException(nameof(bindingContext));

        var valueProviderResult = bindingContext.ValueProvider.GetValue(bindingContext.ModelName);
        if (valueProviderResult == ValueProviderResult.None)
            return Task.CompletedTask;

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

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

        // 清理空格后尝试转换
        var cleanedInput = input.Replace(" ", "");
        if (decimal.TryParse(cleanedInput, out var result))
        {
            bindingContext.Result = ModelBindingResult.Success(result);
        }
        else
        {
            // 添加自定义错误消息，覆盖默认提示
            bindingContext.ModelState.AddModelError(bindingContext.ModelName, "Enter the amount correctly");
        }

        return Task.CompletedTask;
    }
}

2. 绑定到目标属性：

[BindProperty]
[Required(ErrorMessage = "Enter the valid amount")]
[ModelBinder(BinderType = typeof(DecimalModelBinder))]
public decimal? QuoteAmountTotal { get; set; }

或者全局注册（所有decimal?字段自动生效）：
在Startup.cs的ConfigureServices中添加：

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

效果验证 #

两种方案都能让输入2 0 0 0时，显示自定义错误消息Enter the amount correctly，而非默认的类型不匹配提示。

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