Spring Boot中javax.validation注解的格式化验证消息配置问题

你遇到的Attribute value must be constant错误，是因为Java注解的属性值必须是编译期常量，而String.format()是运行时计算的方法，无法作为注解属性值。以下提供几种符合你需求的解决方案：

方案一：为每个字段定义专属常量消息（最直接） #

在统一的常量类中为每个字段单独定义验证消息，确保所有消息集中管理，避免重复编写文本：

// 统一的验证消息常量类
public class ValidationMessages {
    public static final String TITLE_CANNOT_EMPTY = "title field cannot be empty";
    public static final String CONTENT_CANNOT_EMPTY = "content field cannot be empty";
    // 其他字段的验证消息常量
}

在请求类中直接引用：

@Value
public class CreatePostRequest {
    @NotBlank(message = ValidationMessages.TITLE_CANNOT_EMPTY)
    private String title;

    @NotBlank(message = ValidationMessages.CONTENT_CANNOT_EMPTY)
    private String content;
    // 其他字段
}

这种方法简单可靠，完全符合Java注解对常量值的要求，且所有消息统一维护在常量类中。

方案二：自定义验证注解（适合大量重复验证场景） #

如果有大量字段需要相同逻辑的验证（比如非空），可以自定义注解，通过传入字段名来动态生成消息，同时保留统一的消息模板：

1. 自定义注解 #

import javax.validation.Constraint;
import javax.validation.Payload;
import java.lang.annotation.*;

@Target({ElementType.FIELD, ElementType.METHOD, ElementType.PARAMETER})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = FieldNotBlankValidator.class)
public @interface FieldNotBlank {
    // 统一的消息模板
    String message() default "%s field cannot be empty";
    // 需要传入的字段名称
    String fieldName();
    
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

2. 实现验证器逻辑 #

import javax.validation.ConstraintValidator;
import javax.validation.ConstraintValidatorContext;

public class FieldNotBlankValidator implements ConstraintValidator<FieldNotBlank, String> {
    private String fieldName;
    private String messageTemplate;

    @Override
    public void initialize(FieldNotBlank constraintAnnotation) {
        this.fieldName = constraintAnnotation.fieldName();
        this.messageTemplate = constraintAnnotation.message();
    }

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        if (value == null || value.isBlank()) {
            // 禁用默认消息，替换为动态生成的消息
            context.disableDefaultConstraintViolation();
            context.buildConstraintViolationWithTemplate(String.format(messageTemplate, fieldName))
                    .addConstraintViolation();
            return false;
        }
        return true;
    }
}

3. 在请求类中使用 #

@Value
public class CreatePostRequest {
    @FieldNotBlank(fieldName = "title")
    private String title;

    @FieldNotBlank(fieldName = "content")
    private String content;
    // 其他字段
}

这种方式只需维护一个消息模板，每个字段仅需传入名称，适合字段较多的场景。

方案三：利用Hibernate Validator的EL表达式（进阶） #

Spring Boot默认使用Hibernate Validator作为JSR-380的实现，它支持在注解消息中使用EL表达式动态替换内容。你可以通过EL调用常量类的方法来生成消息：

首先定义常量模板：

public class ValidationMessages {
    public static final String CANNOT_EMPTY = "%s field cannot be empty";
    
    // 提供静态方法用于格式化消息
    public static String formatCannotEmpty(String fieldName) {
        return String.format(CANNOT_EMPTY, fieldName);
    }
}

然后在注解中通过EL调用该方法：

@Value
public class CreatePostRequest {
    @NotBlank(message = "#{T(com.yourpackage.ValidationMessages).formatCannotEmpty('title')}")
    private String title;
    
    @NotBlank(message = "#{T(com.yourpackage.ValidationMessages).formatCannotEmpty('content')}")
    private String content;
}

注意：com.yourpackage需要替换为你实际的常量类包路径，这种方式依赖Hibernate Validator的EL支持，兼容性稍弱，但能实现动态消息模板。

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