如何在JPA Validation错误消息中通用化包含字段名？

1. 直接使用内置表达式 ${propertyPath} #

JPA Validation的默认实现（如Hibernate Validator）提供了内置表达式${propertyPath}，可直接在校验注解的消息模板中引用，自动替换为当前校验的字段名。

示例代码：

@Pattern(
    regexp = "^[A-Za-z0-9]+$",
    message = "${propertyPath}格式无效，当前输入值：${validatedValue}"
)
private String username;

当字段username校验失败时，错误消息会自动生成为：username格式无效，当前输入值：xxx。如果是嵌套对象的字段（如user.address.zipCode），${propertyPath}会输出完整的属性路径。

2. 自定义消息插值器实现字段名别名（如中文显示） #

如果需要将英文字段名替换为更友好的别名（比如中文），可以自定义消息插值器扩展逻辑：

步骤1：实现自定义插值器

public class CustomFieldNameInterpolator extends ResourceBundleMessageInterpolator {
    @Override
    public String interpolate(String messageTemplate, Context context) {
        String baseMessage = super.interpolate(messageTemplate, context);
        String fieldPath = context.getPropertyPath().toString();
        // 从映射关系中获取字段别名，可替换为从配置文件/枚举读取
        String fieldAlias = getFieldAlias(fieldPath);
        return baseMessage.replace("${fieldAlias}", fieldAlias);
    }

    private String getFieldAlias(String fieldPath) {
        Map<String, String> aliasMap = new HashMap<>();
        aliasMap.put("username", "用户名");
        aliasMap.put("email", "邮箱");
        return aliasMap.getOrDefault(fieldPath, fieldPath);
    }
}

步骤2：配置插值器生效（以Spring Boot为例）

@Configuration
public class ValidatorConfiguration {
    @Bean
    public Validator validator() {
        return Validation.byProvider(HibernateValidator.class)
                .configure()
                .messageInterpolator(new CustomFieldNameInterpolator())
                .buildValidatorFactory()
                .getValidator();
    }
}

步骤3：在注解中使用别名占位符

@Pattern(
    regexp = "^[A-Za-z0-9]+$",
    message = "${fieldAlias}格式无效，当前输入值：${validatedValue}"
)
private String username;

此时校验失败会输出：用户名格式无效，当前输入值：xxx，后续字段名变更只需修改aliasMap，无需逐个修改注解。

3. 自定义校验注解固化规则（针对重复场景） #

如果多个字段使用相同的校验规则，可以自定义注解，把包含字段名的消息模板固化进去，避免重复编写：

@Target({FIELD, METHOD, PARAMETER, ANNOTATION_TYPE})
@Retention(RUNTIME)
@Constraint(validatedBy = {})
@Pattern(regexp = "^[A-Za-z0-9]+$")
public @interface Alphanumeric {
    String message() default "${propertyPath}必须由字母或数字组成，当前输入值：${validatedValue}";
    Class<?>[] groups() default {};
    Class<? extends Payload>[] payload() default {};
}

使用时直接标注字段即可：

@Alphanumeric
private String username;

@Alphanumeric
private String password;

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