Micronaut自定义校验注解无法生效，求排查方案

1. 自定义注解缺失@Target声明 #

你的@FieldValidator注解没指定作用目标（比如字段、参数），JVM没法识别该注解该应用到哪些元素上，直接导致校验框架看不到字段上的注解。

修复后的注解代码：

@Retention(RUNTIME)
@Target(FIELD, PARAMETER) // 新增目标声明，支持字段和参数场景
@Constraint(validatedBy = [])
annotation class FieldValidator(
    val message: String = "invalid format ({validatedValue})"
)

2. 确认校验依赖已引入 #

检查build.gradle.kts（或build.gradle）是否包含Micronaut校验核心依赖：

implementation("io.micronaut.validation:micronaut-validation")

要是缺了这个依赖，就算代码写得再对，校验机制也启动不了。

3. 调整Validator实现逻辑 #

你的Validator里设置消息模板的时机有问题——应该先判断值是否无效，再设置错误信息，别每次都覆盖模板。另外还要处理字段为null的情况（你的字段是String?，可能传null）：

修复后的Factory代码：

@Factory
class ValidatorFactory {

    @Singleton
    fun fieldPatternValidator(): ConstraintValidator<FieldValidator, CharSequence> {
        return ConstraintValidator { value, annotation, context ->
            if (value == null) {
                // 允许null就返回true，不允许就返回false并设置对应消息
                true
            } else {
                val isValid = value == "test"
                if (!isValid) {
                    context.messageTemplate(annotation.message)
                }
                isValid
            }
        }
    }
}

4. 验证校验异常处理 #

Micronaut默认会把校验错误转成400 Bad Request，只要@Valid注解生效，校验失败就会自动返回400，不用额外写异常处理器。

测试验证 #

按你给的步骤重新测试：

• 执行./gradlew run启动项目
• 调用http://localhost:8080/hello?field=abc，此时应该返回400 Bad Request，带上你定义的错误提示。

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