OpenAPI2+Spring Boot非首路径参数校验失效报500问题

这个现象是Spring MVC路径匹配、参数绑定的执行逻辑和OpenAPI生成代码的配置不匹配导致的，核心逻辑如下：

• Spring MVC处理带路径参数的请求时，会按照路径段顺序依次做参数类型转换，只有当前路径段的转换逻辑执行通过，才会继续处理下一个路径段。你遇到的第一个color参数非法时返回400，本质是Controller方法里这个参数直接声明为了对应的Java枚举类型，Spring在匹配第一个路径段时，发现传入的abc无法转换为枚举常量，直接抛出TypeMismatchException，被框架默认的异常处理器捕获返回400，请求根本不会进入Controller业务逻辑。
• 第二个make、第三个modelno参数没有被提前拦截，绝大多数情况是OpenAPI生成的Controller方法签名有问题：
  • make参数没有被生成为对应的枚举类型，而是被定义成了普通String类型。这种情况下Spring不会做枚举值转换，任何传入的字符串都会被直接接收，哪怕你传的是小写suzuki和枚举定义的大写开头Suzuki不匹配，框架也不会感知，请求直接进入Controller层，流转到Service层做业务判断时才抛出非法参数异常，如果这个异常没有被全局异常处理器捕获，就会返回500。
  • modelno参数的正则校验规则没有被生成为Spring可识别的校验注解（比如@Pattern），或者Controller类/方法没有加@Validated注解开启方法级别的JSR校验。Spring默认不会自动触发路径参数的Bean Validation逻辑，没有注解和@Validated标记的话，正则规则根本不会在请求接入阶段生效，非法的modelno字符串会直接透传到业务层，最终抛出未捕获异常触发500。
• 这是OpenAPI 2.0（Swagger 2）生成Spring服务端代码的常见问题：如果代码生成配置里没有开启枚举类型强绑定、自动添加校验注解的开关，生成的方法只会给第一个路径参数匹配枚举类型，后续路径参数默认生成为String类型，也不会自动附加校验规则。

• 先查看生成的Controller方法签名：确认make参数的类型是对应枚举类而非String，modelno参数上是否加了对应正则的@Pattern注解。
• 给Controller类添加@Validated注解，开启Spring方法级别的参数校验，校验不通过时会抛出ConstraintViolationException。
• 配置全局异常处理器，统一捕获TypeMismatchException、ConstraintViolationException、IllegalArgumentException三类参数相关异常，统一返回400状态码，避免未捕获的异常走到500响应逻辑。

OpenAPI定义本身只是接口描述规则，不会自动让框架执行校验逻辑，所有规则必须落地为Spring可识别的参数类型、校验注解、异常拦截配置，才会实际生效。

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