Razor表单复用对象时，如何为验证错误消息添加前缀区分？

针对你遇到的在Razor表单中复用同一个Person类实例，导致验证错误消息完全相同、无法区分来源的问题，这里有几个实用方案，重点解决错误消息前缀添加的需求：

方案1：利用内置Display特性+错误消息占位符（最简洁推荐） #

ASP.NET MVC的验证系统支持在错误消息中使用占位符{0}，它会自动拼接父属性和子属性的友好名称。我们只需要给父对象和子属性添加[Display]特性：

public class Person
{
    [Required(ErrorMessage = "{0} is Required")]
    [StringLength(30, ErrorMessage = "{0} must be 30 characters or less")]
    [Display(Name = "First Name")]
    public string FirstName { get; set; }
}

public class User
{
    [Required]
    [Display(Name = "User")]
    public Person User { get; set; }

    [Required]
    [Display(Name = "Next of Kin")]
    public Person NextOfKin { get; set; }
}

当验证失败时，错误消息会自动生成为：User First Name is Required和Next of Kin First Name is Required，完美区分两个字段的来源，而且完全复用内置验证逻辑，代码最简洁易维护。

方案2：自定义带前缀的验证特性（高度定制场景） #

如果需要更灵活的前缀控制，比如不想依赖Display特性，可以创建自定义验证特性，允许手动传入前缀参数：

// 自定义Required特性，支持添加前缀
public class RequiredWithPrefixAttribute : RequiredAttribute
{
    public string Prefix { get; set; }

    public override string FormatErrorMessage(string name)
    {
        return string.IsNullOrEmpty(Prefix) 
            ? base.FormatErrorMessage(name) 
            : $"{Prefix}: {base.FormatErrorMessage(name)}";
    }
}

// 同理给StringLength也做自定义扩展
public class StringLengthWithPrefixAttribute : StringLengthAttribute
{
    public string Prefix { get; set; }

    public StringLengthWithPrefixAttribute(int maximumLength) : base(maximumLength) { }

    public override string FormatErrorMessage(string name)
    {
        return string.IsNullOrEmpty(Prefix) 
            ? base.FormatErrorMessage(name) 
            : $"{Prefix}: {base.FormatErrorMessage(name)}";
    }
}

然后在User类中通过元数据类为不同实例设置前缀：

public class Person
{
    public string FirstName { get; set; }
}

public class User
{
    [Required]
    [MetadataType(typeof(UserPersonMetadata))]
    public Person User { get; set; }

    [Required]
    [MetadataType(typeof(NextOfKinPersonMetadata))]
    public Person NextOfKin { get; set; }
}

// 为User的Person实例设置前缀
public class UserPersonMetadata
{
    [RequiredWithPrefix(Prefix = "User", ErrorMessage = "First Name is Required")]
    [StringLengthWithPrefix(30, Prefix = "User", ErrorMessage = "First Name must be 30 characters or less")]
    public string FirstName { get; set; }
}

// 为NextOfKin的Person实例设置前缀
public class NextOfKinPersonMetadata
{
    [RequiredWithPrefix(Prefix = "Next of Kin", ErrorMessage = "First Name is Required")]
    [StringLengthWithPrefix(30, Prefix = "Next of Kin", ErrorMessage = "First Name must be 30 characters or less")]
    public string FirstName { get; set; }
}

这种方式适合需要完全自定义前缀规则的场景，但代码量会稍大。

方案3：前端视图手动处理错误消息（快速临时修复） #

如果不想改动后端代码，可以直接在Razor视图中遍历模型状态，为不同来源的错误添加前缀：

@{
    // 筛选User相关的错误并添加前缀
    var userErrors = ViewData.ModelState
        .Where(kv => kv.Key.StartsWith("User."))
        .SelectMany(kv => kv.Value.Errors)
        .Select(err => $"User: {err.ErrorMessage}");
    
    // 筛选NextOfKin相关的错误并添加前缀
    var nextOfKinErrors = ViewData.ModelState
        .Where(kv => kv.Key.StartsWith("NextOfKin."))
        .SelectMany(kv => kv.Value.Errors)
        .Select(err => $"Next of Kin: {err.ErrorMessage}");
    
    var allErrors = userErrors.Concat(nextOfKinErrors);
}

@if (allErrors.Any())
{
    <div class="validation-summary-errors alert alert-danger">
        <ul>
            @foreach (var error in allErrors)
            {
                <li>@error</li>
            }
        </ul>
    </div>
}

这种方式无需修改后端，适合快速临时解决问题，但如果字段较多，维护成本会比较高。

总结推荐 #

最推荐使用方案1，它利用ASP.NET MVC内置的验证机制，代码简洁、易于维护，完全满足错误消息区分的需求，不需要额外的自定义代码或前端处理。

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