Spring Boot Kotlin项目中自定义Javax Validation注解按条件设置本地化消息的方式是否正确？

你当前的思路方向是对的——通过禁用默认约束违反、在不同条件分支添加自定义模板消息来实现多条件的本地化提示，但有几个细节处理错误，导致消息没有按预期显示。我们来一步步修正：

核心问题分析 #

1. 消息键的命名空间错误：你在验证器里用了{javax.validation.constraints.MyAnnotation.conditionOne}作为模板，但javax.validation.constraints.是官方内置约束（比如@NotNull、@Size）的命名空间，自定义注解的消息键不需要加这个前缀，直接用你的注解类名作为前缀即可。
2. 属性文件键名与模板不匹配：你在属性文件里配置的是MyAnnotation.value，但验证器里引用的是MyAnnotation.message或conditionOne，键名完全不对应，系统自然找不到正确的消息。
3. 代码拼写错误：你写的ConditonTwo是笔误（少了一个i），会导致这个条件分支永远不会被触发，可能让你误以为消息逻辑有问题。
4. 注解默认message设置没必要：把message设为空字符串其实没用，因为你已经调用了context.disableDefaultConstraintViolation()，默认的message不会生效。

修正后的完整实现 #

1. 修正自定义注解 #

保持默认message的占位符，但使用自定义的键前缀（去掉javax的命名空间）：

@Target(AnnotationTarget.Field)
@Constraint(validatedBy = [MyCustomValidator::class])
annotation class MyAnnotation(
    val message: String = "{MyAnnotation.message}", // 用自定义注解类名作为键前缀
    val groups: Array<KClass<*>> = [],
    val payload: Array<KClass<out Payload>> = []
)

2. 配置本地化属性文件 #

确保属性文件（比如messages_en.properties或messages_zh_CN.properties）中的键与模板完全对应：

# 默认消息
MyAnnotation.message=This field is required
# 条件一的提示
MyAnnotation.conditionOne=This field does not meet condition one
# 条件二的提示
MyAnnotation.conditionTwo=This field does not meet condition two

3. 修正验证器代码 #

修复拼写错误，使用正确的模板占位符，确保逻辑分支正确：

class MyCustomValidator : ConstraintValidator<MyAnnotation, String> {
    override fun isValid(value: String, context: ConstraintValidatorContext): Boolean {
        // 禁用默认的约束违反提示，必须放在最前面
        context.disableDefaultConstraintViolation()

        return when {
            // 条件一不满足时，添加对应本地化消息
            !ConditionOne.isValid(value) -> {
                context.buildConstraintViolationWithTemplate("{MyAnnotation.conditionOne}")
                    .addConstraintViolation()
                false
            }
            // 条件二不满足时，添加对应本地化消息（修复拼写错误ConditonTwo -> ConditionTwo）
            !ConditionTwo.isValid(value) -> {
                context.buildConstraintViolationWithTemplate("{MyAnnotation.conditionTwo}")
                    .addConstraintViolation()
                false
            }
            // 所有条件满足时返回true
            else -> true
        }
    }
}

额外注意事项 #

• 确保你的Locale拦截器正常工作，能正确加载对应语言的properties文件。
• 属性文件必须放在src/main/resources目录下，命名符合Spring Boot的本地化文件规则（比如messages_zh_CN.properties对应中文简体）。
• 如果需要给不同字段设置不同的默认消息，可以在使用注解时手动指定message属性，比如@MyAnnotation(message = "{custom.key}")。

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