Spring Boot PathVariable未传递返回404，需改为400并自定义响应

核心原因 #

当访问/observability-core/v1/systems/时，Spring MVC找不到匹配的控制器方法（你的方法只匹配带{systemId}的路径），因此直接由DispatcherServlet返回404，请求根本没进入控制器逻辑，自然不会产生相关日志，这种404会误导用户以为资源不存在，而非参数缺失。

下面提供三种可行的解决方案：

方案一：新增空路径匹配端点直接返回400 #

在对应控制器中添加一个匹配空路径的GET方法，专门处理缺失路径变量的请求：

@RestController
@RequestMapping("/observability-core/v1/systems")
public class SystemController {

    // 原有带路径变量的业务方法
    @GetMapping("/{systemId}")
    public ResponseEntity<String> getSystemDetails(@PathVariable String systemId) {
        // 业务逻辑实现
        return ResponseEntity.ok("System ID: " + systemId);
    }

    // 处理缺失systemId的请求，返回400
    @GetMapping("")
    public ResponseEntity<Map<String, Object>> handleMissingSystemId() {
        Map<String, Object> errorResp = new HashMap<>();
        errorResp.put("timestamp", LocalDateTime.now().format(DateTimeFormatter.ISO_DATE_TIME));
        errorResp.put("status", HttpStatus.BAD_REQUEST.value());
        errorResp.put("error", "Bad Request");
        errorResp.put("message", "必须提供systemId路径变量");
        errorResp.put("path", "/observability-core/v1/systems/");

        return new ResponseEntity<>(errorResp, HttpStatus.BAD_REQUEST);
    }
}

优势：简单直接，请求会进入控制器，正常生成日志，响应清晰提示参数问题。

方案二：自定义全局ErrorController处理特定404场景 #

通过实现ErrorController，拦截所有错误请求，判断是否是目标缺失路径变量的场景，将404转为400响应：

@RestController
public class CustomErrorHandler implements ErrorController {

    private static final String ERROR_ENDPOINT = "/error";

    @RequestMapping(ERROR_ENDPOINT)
    public ResponseEntity<Map<String, Object>> handleError(HttpServletRequest request) {
        Integer statusCode = (Integer) request.getAttribute(RequestDispatcher.ERROR_STATUS_CODE);
        String requestPath = (String) request.getAttribute(RequestDispatcher.ERROR_REQUEST_URI);

        Map<String, Object> errorResp = new HashMap<>();
        errorResp.put("timestamp", LocalDateTime.now().format(DateTimeFormatter.ISO_DATE_TIME));
        errorResp.put("path", requestPath);

        // 判断是否是目标缺失路径变量的请求
        if (HttpStatus.NOT_FOUND.value() == statusCode && "/observability-core/v1/systems/".equals(requestPath)) {
            errorResp.put("status", HttpStatus.BAD_REQUEST.value());
            errorResp.put("error", "Bad Request");
            errorResp.put("message", "缺失必填路径变量systemId");
            return new ResponseEntity<>(errorResp, HttpStatus.BAD_REQUEST);
        }

        // 其他错误保持默认处理逻辑
        errorResp.put("status", statusCode);
        errorResp.put("error", HttpStatus.valueOf(statusCode).getReasonPhrase());
        return new ResponseEntity<>(errorResp, HttpStatus.valueOf(statusCode));
    }

    @Override
    public String getErrorPath() {
        return ERROR_ENDPOINT;
    }
}

优势：无需修改原有控制器，可批量处理多个类似的路径变量缺失场景。

方案三：自定义路径匹配逻辑+全局异常捕获（进阶） #

通过重写RequestMappingHandlerMapping提前拦截缺失路径变量的请求，抛出异常后用@ControllerAdvice统一处理：

1. 自定义HandlerMapping：

@Component
public class CustomPathHandlerMapping extends RequestMappingHandlerMapping {

    @Override
    protected HandlerExecutionChain getHandlerInternal(HttpServletRequest request) throws Exception {
        String requestUri = getUrlPathHelper().getPathWithinApplication(request);
        // 匹配目标缺失路径变量的请求
        if ("/observability-core/v1/systems/".equals(requestUri)) {
            throw new MissingPathVariableException("systemId", new MethodParameter(null, 0));
        }
        return super.getHandlerInternal(request);
    }
}

2. 全局异常捕获：

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(MissingPathVariableException.class)
    public ResponseEntity<Map<String, Object>> handleMissingPathVariable(MissingPathVariableException ex, HttpServletRequest request) {
        Map<String, Object> errorResp = new HashMap<>();
        errorResp.put("timestamp", LocalDateTime.now().format(DateTimeFormatter.ISO_DATE_TIME));
        errorResp.put("status", HttpStatus.BAD_REQUEST.value());
        errorResp.put("error", "Bad Request");
        errorResp.put("message", "必填路径变量[" + ex.getVariableName() + "]未提供");
        errorResp.put("path", request.getRequestURI());

        return new ResponseEntity<>(errorResp, HttpStatus.BAD_REQUEST);
    }
}

优势：实现逻辑解耦，适合复杂场景下批量处理所有路径变量缺失的情况，请求会进入应用并生成完整日志。

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