Spring HTTP Interface如何以逗号分隔传递List类型请求参数？

方式一：全局配置UriBuilderFactory的参数风格 #

通过配置WebClient的DefaultUriBuilderFactory，设置参数风格为逗号分隔，让所有List类型的请求参数自动以逗号拼接格式生成：

@Bean
public WebClient webClient() {
    DefaultUriBuilderFactory uriBuilderFactory = new DefaultUriBuilderFactory();
    // 设置List参数以逗号分隔形式拼接
    uriBuilderFactory.setQueryParamStyle(DefaultUriBuilderFactory.QueryParamStyle.COMMA_SEPARATED);
    
    return WebClient.builder()
            .uriBuilderFactory(uriBuilderFactory)
            .build();
}

配置完成后，你的@HttpExchange接口代理生成请求时，List<String> ids参数会自动转换为ids=1,2,...的格式，无需手动预处理。

注意：该配置为全局生效，所有使用此WebClient的接口中，List类型请求参数都会采用逗号分隔格式。

方式二：自定义参数转换器（灵活控制范围） #

如果不想全局修改参数风格，仅针对特定类型参数处理，可以自定义转换器实现类型转换，并注册到WebClient的编码策略中：

1. 实现Converter接口：

import org.springframework.core.convert.converter.Converter;
import java.util.List;

public class ListToStringConverter implements Converter<List<String>, String> {
    @Override
    public String convert(List<String> source) {
        return String.join(",", source);
    }
}

2. 注册到WebClient的编码策略：

@Bean
public WebClient webClient() {
    ExchangeStrategies strategies = ExchangeStrategies.builder()
            .codecs(configurer -> {
                // 注册自定义转换器，处理List<String>到String的转换
                configurer.defaultCodecs().registerConverter(new ListToStringConverter());
            })
            .build();
    
    return WebClient.builder()
            .exchangeStrategies(strategies)
            .build();
}

此方式会让Spring在处理List<String>类型的请求参数时，自动应用该转换器生成逗号分隔的参数字符串。

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