SpringBoot中含斜杠及特殊字符的PathVariable处理方案求助

问题分析 #

原代码中@GetMapping("/test/{id}")的路径变量id包含/、*这类特殊字符时，Spring会默认将/解析为路径分隔符，导致参数截取错误；同时*属于URL特殊字符，直接传递会被浏览器或服务器解析为通配符，无法正确获取参数值。

可行方案 #

方案1：使用通配符路径匹配剩余内容 #

将接口路径改为/test/**，让Spring匹配/test/之后的所有内容作为id，同时调整路径匹配配置确保能正确解析。

步骤1：修改接口代码

修正原代码的语法错误（Public改为public，补充参数类型），并调整路径：

@GetMapping(value = "/test/**")
public TestClass getData(@PathVariable String id) {
    // 此处id会自动获取/test/后的完整内容，已自动解码URL编码后的特殊字符
    return testService.getDataService(id);
}

步骤2：配置路径匹配规则

添加配置类，确保Spring不会截断路径变量中的斜杠：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
        // 关闭后缀匹配和 trailing slash 匹配，避免干扰
        configurer.setUseSuffixPatternMatch(false)
                  .setUseTrailingSlashMatch(false);
        // 自定义路径解析，确保完整获取剩余路径
        UrlPathHelper urlPathHelper = new UrlPathHelper();
        urlPathHelper.setRemoveSemicolonContent(false); // 保留分号内容（如果有）
        configurer.setUrlPathHelper(urlPathHelper);
    }
}

方案2：URL编码+调整路径匹配策略 #

让前端对id进行URL编码（将/转为%2F，*转为%2A），再通过原路径格式传递，同时修改Spring配置允许路径变量包含编码后的斜杠。

步骤1：前端编码参数

将示例值00/01*1编码为00%2F01%2A1，请求URL变为/test/00%2F01%2A1。

步骤2：修改接口配置

在application.properties中添加配置，使用Ant路径匹配器并允许编码斜杠：

spring.mvc.pathmatch.matching-strategy=ant_path_matcher

步骤3：修正接口代码

修正原语法错误后保留原路径：

@GetMapping(value = "/test/{id}")
public TestClass getData(@PathVariable("id") String id) {
    // Spring会自动解码URL编码后的参数，得到原始的00/01*1
    return testService.getDataService(id);
}

注意事项 #

• 无论哪种方案，前端必须对含特殊字符的参数进行URL编码，否则浏览器会自动转义或截断参数，导致服务器无法正确接收。
• 使用方案1时，需确保/test/**路径不会与其他接口路径冲突，避免路由混乱。

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