Spring Boot自定义ConstraintValidator处理@PathVariable空值异常问题

当给@PathVariable("code")传空值时校验器拿到:code而非null，本质是两个原因：

1. 请求URL格式错误：比如在Postman中直接发送了/employees/:code，而非正确的空值请求/employees/；
2. Spring MVC默认解析逻辑：即使URL中code位置为空，Spring也不会自动将其转为null，反而可能把占位符标识作为值传入。

1. 修正请求URL格式 #

在Postman中发送空值请求时，URL应为GET /employees/（末尾保留斜杠），不要把:code作为路径的一部分发送。

2. 自定义路径变量解析器，将空值转为null #

创建Spring MVC配置类，覆盖默认的路径变量解析逻辑，把空字符串或占位符标识转为null：

import org.springframework.context.annotation.Configuration;
import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import org.springframework.web.servlet.mvc.method.annotation.PathVariableMethodArgumentResolver;

import java.util.List;

@Configuration
public class WebMvcCustomConfig implements WebMvcConfigurer {
    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        PathVariableMethodArgumentResolver customResolver = new PathVariableMethodArgumentResolver() {
            @Override
            protected Object resolveName(String paramName, MethodParameter parameter, NativeWebRequest request) throws Exception {
                Object resolvedValue = super.resolveName(paramName, parameter, request);
                
                // 处理空字符串转null
                if (resolvedValue instanceof String && ((String) resolvedValue).isEmpty()) {
                    return null;
                }
                // 处理占位符标识（如":code"）转null
                if (resolvedValue instanceof String && ((String) resolvedValue).equals(":" + paramName)) {
                    return null;
                }
                return resolvedValue;
            }
        };
        resolvers.add(customResolver);
    }
}

3. 优化校验器逻辑（兜底处理） #

即使出现:code这类异常值，也能在校验器中直接拦截：

public class InputValidator implements ConstraintValidator<ValidInput, String> {

    @Override
    public void initialize(ValidInput constraintAnnotation) {}

    @Override
    public boolean isValid(String str, ConstraintValidatorContext context) {
        // 排除null、空字符串、占位符格式的值
        return str != null && !str.isBlank() && !str.startsWith(":");
    }
}

4. 可选：改用@RequestParam（业务允许的话） #

如果code不需要作为路径变量，换成@RequestParam会更省心——未传参或传空值时会直接解析为null：

@Validated
@GetMapping("/employees")
public ResponseEntity<ApiResponse<List<RunwayBean>>> findByCode(
        @ValidInput @RequestParam(value = "code", required = false) String code) {
    // 业务逻辑
}

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