如何全局设置Spring验证约束的默认错误消息？

Spring完全支持为@NotNull这类JSR-380校验约束全局配置统一错误消息，无需在每个注解上手动指定message属性。你的配置未生效，大概率是MessageSource的配置细节存在问题，以下是具体排查和解决步骤：

1. 确认messages.properties的配置 #

• 文件位置与命名：默认情况下Spring的MessageSource会从classpath根目录加载messages.properties（多语言环境可使用messages_zh_CN.properties这类带语言后缀的文件）。如果文件放在子目录（如src/main/resources/i18n/），必须在createMessageSource()方法中指定完整的basename：

  private MessageSource createMessageSource() {
      ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
      messageSource.setBasenames("i18n/messages"); // 对应子目录下的配置文件
      messageSource.setDefaultEncoding("UTF-8");
      return messageSource;
  }
  

• 消息key必须准确：@NotNull的全局消息key是固定的javax.validation.constraints.NotNull.message，示例配置：

  # messages.properties 内容（英文环境）
  javax.validation.constraints.NotNull.message=Need a value here
  # messages_zh_CN.properties 内容（中文环境）
  javax.validation.constraints.NotNull.message=此处必须填写值
  

2. 完善Validator与MessageSource的Bean配置 #

你的现有配置框架是正确的，但要确保createMessageSource()返回的是配置完整的ResourceBundleMessageSource，而非空实现。以下是完整的配置示例：

@Configuration
public class ValidationConfig {

    @Bean
    public MessageSource messageSource() {
        ResourceBundleMessageSource messageSource = new ResourceBundleMessageSource();
        messageSource.setBasenames("messages");
        messageSource.setDefaultEncoding("UTF-8");
        messageSource.setUseCodeAsDefaultMessage(false); // 避免找不到消息时直接返回key字符串
        return messageSource;
    }

    @Bean
    public Validator validator() {
        LocalValidatorFactoryBean validator = new LocalValidatorFactoryBean();
        validator.setValidationMessageSource(messageSource());
        return validator;
    }
}

3. Spring Boot环境的简化配置 #

如果是Spring Boot项目，无需手动声明Validator Bean，只要正确配置MessageSource，Spring会自动将其关联到默认的校验器上，减少配置冗余。

额外提示 #

你可以用同样的方式配置其他校验约束的全局消息，比如：

javax.validation.constraints.Size.message=长度需在{min}至{max}之间
javax.validation.constraints.Email.message=请输入有效的邮箱地址

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