OpenApi(Swagger)整型路径参数传入空格时的异常处理方法

该500报错触发时机早于OpenAPI的参数校验逻辑：当accountId路径参数传入空白字符时，Spring WebFlux路由匹配阶段会直接判定该路径段为空，在PathVariableMethodArgumentResolver中抛出路径变量缺失异常，此时请求还未进入OpenAPI codegen生成的代理接口和业务逻辑层，默认没有对应异常处理就会返回500。
你的参数定义中accountId为int64整数类型，本身规范层面就不支持空白这类非数值传值，但默认生成的代码未覆盖路由匹配阶段的异常拦截，才会导致该问题。

需要同时从OpenAPI规范配置、Spring框架异常兜底两个层面处理：

1. OpenAPI规范层补充约束 #

给accountId参数补充合法值范围约束，同时开启codegen的Bean校验生成开关，从接口定义层明确参数规则，修改后的参数配置如下：

accountId:
  name: accountId
  in: path
  description: "account Id"
  required: true
  schema:
    type: integer
    format: int64
    minimum: 1 # 约束账户ID为正整数，从规则上排除空白、0、负数等非法值
  example: 34562712

openapi-generator生成代码时，开启useBeanValidation=true配置项，生成的Delegate接口会自动带上JSR380校验注解，但要注意：路径参数传空白触发的是路由匹配阶段异常，Bean校验无法拦截，必须配合Spring侧的兜底配置。

2. Spring层做异常兜底与路由约束 #

• 方案一：添加全局异常处理器，捕获路径变量缺失、类型转换异常，统一返回400响应而非500，参考实现：

@RestControllerAdvice
public class InvalidPathParamHandler {
    @ExceptionHandler({MissingPathVariableException.class, TypeMismatchException.class})
    public ResponseEntity<?> handlePathParamError() {
        return ResponseEntity.badRequest().build();
    }
}

• 方案二：给数字类型路径参数添加路径匹配正则，限制accountId段只能匹配数字，传入空白、非数字内容时直接返回404，不会触发参数解析异常。如果使用codegen生成代码，不要直接修改生成的映射路径，在生成配置中通过路径规则配置项给整数类型路径参数追加\\d+正则约束即可，避免代码重新生成后配置被覆盖。

OpenAPI 3.0的pattern正则校验仅对字符串类型参数生效，你定义的accountId是整数类型，无法通过在schema中加正则的方式拦截空白传值，必须配合Spring侧的路由或异常配置才能彻底解决该问题。

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