参数校验结合国际化返回错误提示的核心是通过资源文件动态加载多语言错误消息，使用@notblank等注解引用键名，配置messagesource和localvalidatorfactorybean绑定消息源，全局异常处理器中调用fielderror.getdefaultmessage()获取已翻译消息并封装为前端友好结构。
参数校验结合国际化返回错误提示，核心是让错误消息不写死在代码里，而是根据用户语言环境（如 zh_CN 或 en_US）自动从资源文件中读取对应翻译，并统一封装成前端友好的格式。
配置国际化资源文件
在 resources/i18n/ 下创建标准命名的 properties 文件：
-
messages.properties（默认，推荐填英文或留空作兜底） -
messages_zh_CN.properties（中文） -
messages_en_US.properties（英文）
内容示例（messages_zh_CN.properties）：
user.name.notblank=姓名不能为空<br>user.email.invalid=邮箱格式不正确<br>user.age.min=年龄不能小于{0}
注意：占位符 {0} 后续可被注解参数动态填充，无需硬编码具体数值。
实体类中使用带键名的校验注解
字段上避免写死字符串，改用键名引用资源文件：
@NotBlank(message = "{user.name.notblank}")<br>private String name;<br><br>@Email(message = "{user.email.invalid}")<br>private String email;<br><br>@Min(value = 18, message = "{user.age.min}")<br>private Integer age;
这样校验失败时，Spring 会自动查找当前 Locale 对应的 messages 文件，匹配键名并解析占位符。
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
启用消息源与校验器绑定
确保 Spring 能加载资源并用于校验。在配置类中声明：
@Bean<br>public MessageSource messageSource() {<br> ResourceBundleMessageSource source = new ResourceBundleMessageSource();<br> source.setBasename("i18n/messages"); // 对应 i18n/messages.properties<br> source.setDefaultEncoding("UTF-8");<br> return source;<br>}<br><br>@Bean<br>public LocalValidatorFactoryBean validator(MessageSource messageSource) {<br> LocalValidatorFactoryBean bean = new LocalValidatorFactoryBean();<br> bean.setValidationMessageSource(messageSource);<br> return bean;<br>}
关键点：setValidationMessageSource 这一步不可省略，否则注解里的 {key} 不会被解析。
全局异常处理器中提取并返回友好结构
捕获 MethodArgumentNotValidException，遍历每个 FieldError，调用 getDefaultMessage() —— 它已自动完成国际化翻译：
for (FieldError error : exception.getBindingResult().getFieldErrors()) {<br> String field = error.getField();<br> String message = error.getDefaultMessage(); // ✅ 已按 Locale 翻译好<br> details.add(Map.of("field", field, "message", message));<br>}
最终响应体建议为：
{<br> "code": 400,<br> "msg": "请求参数有误",<br> "details": [<br> {"field": "email", "message": "邮箱格式不正确"},<br> {"field": "name", "message": "姓名不能为空"}<br> ]<br>}
不拼接、不分组，每条错误独立，方便前端精准定位和展示。
