Spring Boot如何处理含逗号的List<String>类型查询参数？

Spring默认会把逗号作为集合类型查询参数的分隔符，而且即使你把逗号转义成%2C，Spring在解析前会先解码成逗号，所以还是会被拆分。下面给几个实用的解决方法：

1. 指定自定义分隔符（Spring 5.2+适用） #

直接在@RequestParam注解里设置delimiter属性，用一个业务中不会用到的字符（比如竖线|、分号;）作为集合参数的分隔符，这样参数内容里的逗号就会被当成普通字符处理：

@GetMapping("/test")
public ResponseEntity<List<String>> getStrings(
    @RequestParam(value = "strings", delimiter = "|") List<String> strings
) {
    return ResponseEntity.ok(strings);
}

• 单个带逗号的参数请求：/test?strings=Testing%2C String，返回结果：["Testing, String"]
• 多个带逗号的参数请求：/test?strings=Testing%2C String|Hello%2C World，返回结果：["Testing, String", "Hello, World"]

2. 禁用自动拆分，手动处理参数 #

如果不需要Spring自动拆分集合，直接把参数当成单个字符串接收，再根据自己的规则处理：

@GetMapping("/test")
public ResponseEntity<List<String>> getStrings(
    @RequestParam("strings") String strings
) {
    // 单个带逗号的字符串直接转成列表
    List<String> result = Collections.singletonList(strings);
    
    // 如果需要支持多个参数，比如用分号分隔，手动拆分
    // List<String> result = Arrays.asList(strings.split(";"));
    
    return ResponseEntity.ok(result);
}

这种方式完全由你控制参数的拆分逻辑，不用担心内容里的逗号被误处理。

3. 自定义解析逻辑（支持引号包裹带逗号的参数） #

如果必须保留逗号作为集合分隔符，同时要区分内容里的逗号，可以自定义参数转换器，让Spring识别引号包裹的内容——把带逗号的参数用双引号括起来，转换器会把引号内的内容当成单个元素：

首先写自定义转换器：

@Component
public class QuotedStringListConverter implements Converter<String, List<String>> {
    @Override
    public List<String> convert(String source) {
        List<String> result = new ArrayList<>();
        // 匹配引号包裹的内容，或者非逗号分隔的内容
        Pattern pattern = Pattern.compile("\"([^\"]+)\"|([^,]+)");
        Matcher matcher = pattern.matcher(source);
        while (matcher.find()) {
            if (matcher.group(1) != null) {
                result.add(matcher.group(1));
            } else if (matcher.group(2) != null) {
                result.add(matcher.group(2).trim());
            }
        }
        return result;
    }
}

然后在配置类里注册这个转换器：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Autowired
    private QuotedStringListConverter quotedStringListConverter;

    @Override
    public void addFormatters(FormatterRegistry registry) {
        registry.addConverter(quotedStringListConverter);
    }
}

• 单个带逗号的参数请求：/test?strings="Testing, String"，返回结果：["Testing, String"]
• 混合请求：/test?strings="Testing, String",Hello,World%2C Foo，返回结果：["Testing, String", "Hello", "World, Foo"]

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