Spring Boot可选路径变量筛选接口404问题求助

当前接口代码试图通过@PathVariable(required = false)实现可选路径变量，但仅当传入全部4个路径参数时能正常访问，缺少任意一个都会返回404：

@GetMapping("/filter/{talla}/{tipo}/{marca}/{palabra}")
public String busqueda(Model model,
                       @PathVariable(name = "talla", required = false) String talla,
                       @PathVariable(name = "tipo", required = false) String tipo,
                       @PathVariable(name = "marca", required = false) String marca,
                       @PathVariable(name = "palabra", required = false) String palabra) {

    List<Zapatilla> zapatillas = servi.todasZapatillas();

    // 筛选逻辑
    if (talla != null) {
        zapatillas = servi.filtrarPorTalla(zapatillas, talla);
    }
    if (tipo != null) {
        zapatillas = servi.filtrarPorTipo(zapatillas, tipo);
    }
    if (marca != null) {
        zapatillas = servi.filtrarPorMarca(zapatillas, marca);
    }
    if (palabra != null) {
        zapatillas = servi.buscarPorNombre(zapatillas, palabra);
    }
    
    model.addAttribute("zapatillas", zapatillas);
    return "shoes.jsp";
} 

问题原因 #

Spring MVC中，@PathVariable(required = false)仅作用于路径中存在该变量占位符但未传值的场景（比如/filter//nike/air这种空占位符），但如果请求路径本身不包含对应占位符的位置，就会直接匹配不到路由规则，返回404。例如请求/filter/40时，路径结构和/filter/{talla}/{tipo}/{marca}/{palabra}完全不匹配，Spring找不到对应的处理方法。

解决方案 #

方案1：改用请求参数（推荐） #

将路径变量改为请求参数，天然支持可选，实现最简单：

@GetMapping("/filter")
public String busqueda(Model model,
                       @RequestParam(name = "talla", required = false) String talla,
                       @RequestParam(name = "tipo", required = false) String tipo,
                       @RequestParam(name = "marca", required = false) String marca,
                       @RequestParam(name = "palabra", required = false) String palabra) {
    // 原筛选逻辑完全复用
    List<Zapatilla> zapatillas = servi.todasZapatillas();
    if (talla != null) {
        zapatillas = servi.filtrarPorTalla(zapatillas, talla);
    }
    if (tipo != null) {
        zapatillas = servi.filtrarPorTipo(zapatillas, tipo);
    }
    if (marca != null) {
        zapatillas = servi.filtrarPorMarca(zapatillas, marca);
    }
    if (palabra != null) {
        zapatillas = servi.buscarPorNombre(zapatillas, palabra);
    }
    
    model.addAttribute("zapatillas", zapatillas);
    return "shoes.jsp";
} 

请求示例：

• 仅按尺码筛选：/filter?talla=40
• 按品牌+关键词筛选：/filter?marca=nike&palabra=air

方案2：定义多路由匹配规则 #

如果必须使用路径变量，需为所有可能的参数组合定义路由：

// 匹配全部4个参数
@GetMapping("/filter/{talla}/{tipo}/{marca}/{palabra}")
// 匹配前3个参数
@GetMapping("/filter/{talla}/{tipo}/{marca}")
// 匹配前2个参数
@GetMapping("/filter/{talla}/{tipo}")
// 匹配仅第一个参数
@GetMapping("/filter/{talla}")
// 匹配无参数（可选）
@GetMapping("/filter")
public String busqueda(Model model,
                       @PathVariable(name = "talla", required = false) String talla,
                       @PathVariable(name = "tipo", required = false) String tipo,
                       @PathVariable(name = "marca", required = false) String marca,
                       @PathVariable(name = "palabra", required = false) String palabra) {
    // 原筛选逻辑完全复用
}

注意：参数越多，需要定义的路由规则越多，且容易和其他接口路由冲突。

方案3：通配符路径+手动解析 #

通过/**匹配任意子路径，手动解析参数：

@GetMapping("/filter/**")
public String busqueda(Model model, HttpServletRequest request) {
    String path = request.getRequestURI().replace("/filter/", "");
    String[] params = path.split("/");
    
    String talla = null;
    String tipo = null;
    String marca = null;
    String palabra = null;
    
    // 按顺序解析参数
    if (params.length > 0 && !params[0].isEmpty()) {
        talla = params[0];
    }
    if (params.length > 1 && !params[1].isEmpty()) {
        tipo = params[1];
    }
    if (params.length > 2 && !params[2].isEmpty()) {
        marca = params[2];
    }
    if (params.length > 3 && !params[3].isEmpty()) {
        palabra = params[3];
    }
    
    // 原筛选逻辑完全复用
    List<Zapatilla> zapatillas = servi.todasZapatillas();
    if (talla != null) {
        zapatillas = servi.filtrarPorTalla(zapatillas, talla);
    }
    if (tipo != null) {
        zapatillas = servi.filtrarPorTipo(zapatillas, tipo);
    }
    if (marca != null) {
        zapatillas = servi.filtrarPorMarca(zapatillas, marca);
    }
    if (palabra != null) {
        zapatillas = servi.buscarPorNombre(zapatillas, palabra);
    }
    
    model.addAttribute("zapatillas", zapatillas);
    return "shoes.jsp";
}

这种方法灵活性高，但需要自行处理参数解析逻辑，适合复杂路径场景。

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