Micronaut 4验证失效：DTO未被校验的问题排查

1. 给控制器类添加@Validated注解 #

Micronaut 4.x 要求必须在控制器类上标注@Validated注解，才能触发方法参数上的@Valid校验逻辑。

修改控制器代码：

import jakarta.validation.Validated;

@Validated // 新增该注解启用控制器校验
@Controller("/trips")
public class TripController {
    @Post
    TripCreateResponse createOne(@Body @Valid TripCreateRequest tripCreateRequest) {
        // 原有业务逻辑
    }
}

2. 处理嵌套DTO的校验逻辑 #

如果LocationDto自身的字段也需要校验（比如经纬度非空），或者你需要确保传入的start/destination不仅不为null，还要符合内部字段规则，必须在嵌套字段上额外添加@Valid注解，否则仅@NotNull只会校验对象是否为null，不会递归校验嵌套对象的字段：

修改TripCreateRequest：

@Data
@AllArgsConstructor
@Introspected
public class TripCreateRequest {

    @NotNull
    @Valid // 新增，触发嵌套对象的校验
    private LocationDto start;

    @NotNull
    @Valid // 新增
    private LocationDto destination;
}

3. 确保依赖版本严格对齐 #

Micronaut 4.x 要求所有核心组件版本完全一致，检查pom.xml中${micronaut.validation.version}是否与${micronaut.core.version}（即4.6.1）完全相同，版本不匹配会导致校验逻辑无法正常加载。

4. 修正注解处理器配置 #

移除micronaut-validation-processor中对micronaut-inject的排除规则，该排除会导致校验处理器无法生成必要的代理类，进而失效：

修改Maven编译插件的注解处理器部分：

<path>
  <groupId>io.micronaut.validation</groupId>
  <artifactId>micronaut-validation-processor</artifactId>
  <version>${micronaut.validation.version}</version>
  <!-- 删除下面的exclusions节点 -->
</path>

5. 验证全局校验配置未被禁用 #

检查application.yml或application.properties，确保校验功能未被全局禁用：

micronaut:
  validation:
    enabled: true # 默认值为true，若被设为false会直接关闭校验

6. 清理编译缓存并重新构建 #

编译缓存可能导致注解处理器生成的代码未更新，执行以下命令彻底清理后重新构建：

mvn clean install

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