Spring Boot HTTP请求保留空格问题：Solr查询空格被替换为+

这个问题我之前帮同事排查过，核心就是Spring Boot和Solr对URL空格编码的处理逻辑不一样导致的——Spring默认会把空格转成+，但Solr在处理正则这类查询语法时，会把+当成字面量字符，而不是空格，自然匹配不到数据；而Solr UI里浏览器自动把空格编码成%20，所以能正常工作。下面给你几个靠谱的解决方案：

1. 手动把空格编码成%20 #

在构建查询路径或者参数的时候，直接把空格替换成%20，绕过Spring的默认编码：

String targetTag = "Tag- 1";
// 手动替换空格为%20
String encodedTag = targetTag.replace(" ", "%20");
// 构建正则查询
String solrQuery = "q=tags:/" + encodedTag + "/";

这样发送给Solr的请求就是q=tags:/Tag-%201/，Solr会正确把%20解析成空格，匹配到你要的数据。

2. 改用Solr的精确匹配语法 #

如果你的需求是精确匹配这个带空格的字符串，其实没必要用正则表达式（/.../），直接用双引号包裹查询内容就行——这种情况下，哪怕Spring把空格转成+，Solr也会自动把+识别为空格：

String targetTag = "Tag- 1";
// 用双引号实现精确匹配
String solrQuery = "q=tags:\"" + targetTag + "\"";

发送的请求会是q=tags:"Tag-+1"，Solr处理带引号的查询时，会自动转换+为空格，完美解决问题。

3. 配置Spring的编码策略（适合全局统一处理） #

如果你用的是RestTemplate或者SolrTemplate，可以直接配置它们的URL编码规则，让空格默认编码成%20而不是+：
比如针对RestTemplate，自定义Bean配置：

@Bean
public RestTemplate solrRestTemplate() {
    RestTemplate restTemplate = new RestTemplate();
    DefaultUriBuilderFactory uriFactory = new DefaultUriBuilderFactory();
    // 设置编码模式为URI_COMPONENT，强制空格编码为%20
    uriFactory.setEncodingMode(DefaultUriBuilderFactory.EncodingMode.URI_COMPONENT);
    restTemplate.setUriTemplateHandler(uriFactory);
    return restTemplate;
}

之后用这个配置好的RestTemplate发送请求，所有空格都会被编码成%20，完全适配Solr的要求。

简单总结下：如果只是个别查询有问题，用前两种方法快速解决；如果项目里很多地方都要处理带空格的Solr查询，第三种全局配置的方式更省心。

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