ASP.NETCore模型验证消息的本地化新姿势详解
来源：互联网 2026-04-08 18:43:02在实现系统本地化时，模型验证消息的本地化是一个关键环节。这些直接展示给用户的错误信息，其友好性与准确性至关重要。 问题起源 在标准MVC架构中，我们通常使用数据注解来装饰模型类，以实现参数绑定与验证。一个典型的示例如下： public class UserDto { [Required(ErrorM
在实现系统本地化时，模型验证消息的本地化是一个关键环节。这些直接展示给用户的错误信息，其友好性与准确性至关重要。
问题起源
在标准MVC架构中，我们通常使用数据注解来装饰模型类，以实现参数绑定与验证。一个典型的示例如下：
public class UserDto
{
[Required(ErrorMessage = "姓名不能为空")]
public string Name{get; set;}
[Required(ErrorMessage = "年龄不能为空")]
[Range(1, 120, ErrorMessage = "年龄必须在1到120之间")]
public int Age {get; set;}
}
从功能上看，这没有问题。但当面临大量模型需要本地化时，问题便出现了——这几乎是一项重复的体力劳动。
这引出了一个核心问题：我们是否必须为每个属性手动指定ErrorMessage？框架提供的默认错误消息能否使用？除了字段名不同，手动编写的提示信息结构几乎一致，这种重复劳动似乎没有必要。
默认消息分析
基于这个疑问，我们尝试删除所有自定义的ErrorMessage：
public class UserDto
{
[Required]
public string Name{get; set;}
[Required]
[Range(1, 120)]
public int Age {get; set;}
}
运行验证，当参数缺失时，得到的消息是：
"The Name field is required."
"The Age field is required."
默认消息是英文的。这对中文用户不够友好，这也解释了为何之前需要逐一手动设置。
探寻默认消息机制
那么，是否有更彻底的方案？能否直接对框架的默认验证消息进行本地化？如果可以，就能一劳永逸，彻底告别手动设置ErrorMessage的烦恼。
查阅官方源码后，答案逐渐清晰。以RequiredAttribute为例，其默认错误消息来自一个内部类SR：
public RequiredAttribute()
: base(() => SR.RequiredAttribute_ValidationError)
{
}
进一步查看SR类的简化结构：
internal static partial class SR
{
internal static global::System.Resources.ResourceManager ResourceManager => s_resourceManager ?? (s_resourceManager = new global::System.Resources.ResourceManager(typeof(FxResources.System.ComponentModel.Annotations.SR)));
internal static string @RequiredAttribute_ValidationError => GetResourceString("RequiredAttribute_ValidationError", @"The {0} field is required.");
}
这里的逻辑很明确：GetResourceString方法最终会调用内部声明的ResourceManager。该资源管理器会根据运行时文化和传入的类型参数，定位对应的本地化资源文件。
实现默认消息本地化
分析至此，路径已非常清晰。要实现中文默认消息，只需将翻译好的文本放入正确命名的资源文件FxResources.System.ComponentModel.Annotations.SR.zh-CN.resources中即可。
动手前，可以再确认一下。使用ILSpy等工具打开System.ComponentModel.Annotations.dll，确实能看到名为FxResources.System.ComponentModel.Annotations.SR.resources的默认（中立语言）资源，这印证了分析的正确性。
默认资源文件包含了所有验证属性（如Required、Range、StringLength等）的错误消息模板，以及一些内部异常消息。我们可以根据需求，对其进行全部或选择性的本地化。
创建语言扩展包
理论可行，接下来就是实践。我们新建一个类库项目，命名为 FxResources.System.ComponentModel.Annotations。根据.NET的资源命名规则，项目中创建的资源文件会自动加上项目默认命名空间作为前缀。
因此，我们只需在项目中添加一个名为SR的资源文件（.resx）即可。
如图所示，我们分别创建了针对简体中文（zh-Hans）和繁体中文（zh-Hant）的资源文件，并填入对应的翻译内容。这样一来，核心工作就完成了。
这里有个细节需要说明：语言标记zh-Hans（简体中文）兼容zh-CN、zh-SG等地区变体；zh-Hant（繁体中文）则兼容zh-TW、zh-MO、zh-HK。严格来说，港澳台地区的用词习惯略有差异，但在大多数通用场景下，使用统一的繁体中文资源已足够。
验证最终效果
现在，回到最初那个例子，我们不再需要指定任何ErrorMessage：
public class UserDto
{
[Required]
public string Name{get; set;}
[Required]
[Range(1, 120)]
public int Age {get; set;}
}
当验证触发时，用户将看到地道的中文提示，效果立竿见影：
"Name 字段为必填项。"
"Age 字段为必填项。"
需要注意的是：如果项目尚未启用或配置完整的国际化中间件，可能需要在应用启动时显式设置默认的UI文化，例如：CultureInfo.DefaultThreadUICulture = CultureInfo.GetCultureInfo(“zh-Hans”)，以确保资源查找机制能正确生效。
使用NuGet包
为了方便开发者直接使用，已将制作好的中文简体语言资源打包并发布到NuGet。只需在项目中执行以下命令即可安装：
Install-Package FxResources.System.ComponentModel.Annotations.zh-Hans -Version 9.0.0
由于不同版本的.NET框架中，验证消息的文本可能存在细微调整，因此语言包也对应不同的主版本。请根据项目使用的.NET版本，选择对应版本的语言包进行安装，以达到最佳兼容效果。
侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述
