彻底解决Springboot中路径参数带 (%2F)的问题

最新推荐文章于 2025-04-28 18:15:26 发布

KevinDai007

最新推荐文章于 2025-04-28 18:15:26 发布

阅读量1.6k

点赞数

本文链接：https://blog.youkuaiyun.com/KevinDai007/article/details/131355660

版权

文章介绍了如何处理Springboot接口在接收到包含/的路径参数时抛出400错误的问题。通过设置环境变量、关闭Spring自动解码以及调整Springsecurity的HttpFirewall配置，可以允许URL中存在/的参数并正确解析。同时，文章列举了一些常见但无效的解决方案，如正则匹配、自定义配置和使用MatrixVariable。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

彻底解决Springboot中路径参数带/(%2F)的问题

背景

前两天突然出现了一个线上问题，有同事反应我提供的接口报400的错误。接口路径如下 PATCH /v1/basic/owners/{owner_code}/skus/{sku}，经过排查发现是sku参数中有/因此springboot转义后直接报错了。由于已经有很多团队对接了相关接口，且有很多的其他接口都使用了类似的传参方式，因此需要考虑怎么在系统中不让springboot自动解码

解决方案

我先列出可用的解决方案，然后在列出网上常见错误方案

在项目中添加环境变量

System.setProperty("org.apache.tomcat.util.buf.UDecoder.ALLOW_ENCODED_SLASH", "true");

在这里插入图片描述

关闭spring自动decode url的开关

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
   
    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
   
        UrlPathHelper urlPathHelper = new UrlPathHelper();
        urlPathHelper.setUrlDecode(false);
        configurer.setUrlPathHelper(urlPathHelper);
    }
}