Spring Boot REST API非法路径参数校验及返回处理疑问

是否需要主动校验非法路径并返回自定义提示 #

• 如果是内部系统对接、前端和后端约定严格的场景：直接返回默认404完全合理，符合HTTP语义，这类请求本身属于未匹配到业务资源的非法请求，不需要额外定制提示。
• 如果是面向外部开发者的开放API场景：建议返回更明确的错误提示，帮助调用方快速定位参数缺失问题，降低对接沟通成本。

@NotBlank（你提到的@Nonblank为拼写错误）为什么不生效 #

这个注解完全不适配当前场景。
Spring MVC的请求处理流程中，路由匹配逻辑在请求进入Controller方法之前就会执行：你的业务接口路径为/student/{studentId}/course/{courseCode}，只有请求路径完全匹配该结构（两个路径位都有非空值）时，才会路由到对应的Controller方法。
@NotBlank属于方法参数校验注解，仅在请求进入方法后才会触发校验，你提到的非法路径会直接被DispatcherServlet判定为无匹配路由，根本不会进入Controller方法，注解自然不会生效，只会返回默认404/白标签错误页。 #

如何实现非法路径的自定义校验和提示 #

如果确实需要返回定制错误信息，可选两种实现方案：

方案1：全局捕获404异常处理 #

首先修改application配置，开启无匹配路由时抛出异常：

# 适配Spring Boot 2.x/3.x
spring.mvc.throw-exception-if-no-handler-found=true
# 纯接口服务无静态资源时添加，避免静态资源路径干扰
spring.web.resources.add-mappings=false

再编写全局异常处理器做自定义逻辑判断：

@ControllerAdvice
public class GlobalRouteExceptionHandler {

    @ExceptionHandler(NoHandlerFoundException.class)
    public ResponseEntity<Map<String, Object>> handleNoRouteFound(NoHandlerFoundException e) {
        String requestPath = e.getRequestURL();
        // 匹配student相关路径的异常场景
        if (requestPath.startsWith("/student/")) {
            if (requestPath.matches("^/student//.*$")) {
                return ResponseEntity.badRequest().body(Map.of(
                    "code", 400,
                    "msg", "学生ID路径参数不能为空"
                ));
            }
            if (requestPath.matches("^/student/\\d+/course/?$")) {
                return ResponseEntity.badRequest().body(Map.of(
                    "code", 400,
                    "msg", "课程编码路径参数不能为空"
                ));
            }
        }
        // 其他404场景返回通用提示
        return ResponseEntity.status(404).body(Map.of(
            "code", 404,
            "msg", "请求资源不存在"
        ));
    }
}

方案2：新增兜底路由方法 #

单独定义匹配非法路径的Controller方法，针对性返回提示：

// 匹配学生ID为空的场景
@GetMapping("/student//course/**")
public ResponseEntity<Map<String, Object>> handleEmptyStudentId() {
    return ResponseEntity.badRequest().body(Map.of(
        "code", 400,
        "msg", "学生ID路径参数不能为空"
    ));
}

// 匹配课程编码为空的场景
@GetMapping("/student/{studentId}/course/")
public ResponseEntity<Map<String, Object>> handleEmptyCourseCode() {
    return ResponseEntity.badRequest().body(Map.of(
        "code", 400,
        "msg", "课程编码路径参数不能为空"
    ));
}

该方案无需修改全局配置，针对性强，但路径规则较多时维护成本更高。

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