如何在RESTEasy与Vert.x集成项目中启用@Valid注解实现自动参数校验

问题根因 #

你遇到的@Valid注解不生效的核心原因是RESTEasy组件版本不兼容：你直接引入的校验提供者是3.0.11.Final版本，和传递依赖引入的resteasy-vertx 4.5.3.Final核心组件版本差异过大，导致校验拦截逻辑无法正常注册生效。你在方法内手动校验可正常返回错误，也说明校验本身的实现无问题，问题出在RESTEasy的自动校验触发逻辑上。

解决方案 #

按以下步骤调整即可恢复自动校验能力：

• 统一RESTEasy全组件版本
  删掉旧的org.jboss.resteasy:resteasy-validator-provider-11:3.0.11.Final依赖，替换为和resteasy-vertx版本对齐的校验提供者：

  // build.gradle 依赖配置
  implementation 'org.jboss.resteasy:resteasy-validator-provider:4.5.3.Final'
  

  同时全局排除所有传递引入的3.x系列RESTEasy组件，以及旧版hibernate-validation 5.0.1.Final，4.5.3.Final版本的RESTEasy会自动适配兼容的6.x系列Hibernate校验实现。
• 开启校验开关
  在你的JAX-RS应用配置类上添加@EnableValidation注解，显式开启RESTEasy的自动校验能力：

  import org.jboss.resteasy.plugins.validation.EnableValidation;
  import javax.ws.rs.ApplicationPath;
  import javax.ws.rs.core.Application;
  
  @ApplicationPath("/api")
  @EnableValidation
  public class RestAppConfig extends Application {
      // 其他配置逻辑
  }
  

• 确认注解包路径正确
  检查所有校验相关注解的导入路径：@Valid、@NotEmpty都必须来自javax.validation包下，不要混用jakarta.validation命名空间的注解，4.5.3版本的RESTEasy还未迁移到Jakarta EE规范。

调整完成后重新构建启动项目，传入非法参数时会直接触发校验异常返回400响应，不会进入控制器方法体，不需要额外添加validation.xml配置。

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