Spring中如何将@RequestParam绑定到多个相似POJO对象？

这个问题我之前也碰到过，核心原因是Spring默认的参数绑定逻辑会把所有同名的请求参数收集成数组，然后绑定到所有匹配的字段上——你的两个Place对象的country和city字段都和请求参数名匹配，所以每个对象都会拿到所有的参数值，最终显示成逗号分隔的字符串。

下面给你两种实用的解决方案，根据你的场景选就行：

方案一：给请求参数加前缀（推荐，符合Spring常规逻辑） #

这是最简洁的方式，只需要给请求参数加上对应对象的前缀，让Spring能精准区分要绑定的对象：

1. 接口方法可以保持原样，也可以给Place参数加上@ModelAttribute（其实不加Spring也会自动处理）：

public ResponseEntity find(@RequestParam String date, 
                           Place departure, 
                           Place arrival) {
    // 你的业务逻辑
}

2. 修改请求URL，给每个参数加上对应对象的前缀：

/find?date=2019-02-10T16:00:00&departure.country=Russia&departure.city=Samara&arrival.country=Russia&arrival.city=Moscow

这样Spring会自动把带departure.前缀的参数绑定到departure对象，arrival.前缀的绑定到arrival对象，最终就能得到你想要的结果：
Place{country='Russia', city='Samara'} Place{country='Russia', city='Moscow'}

方案二：不修改请求参数，手动/自动分配参数 #

如果没办法修改请求参数的格式，可以通过手动解析或者自定义参数解析器来实现：

方式1：手动接收参数列表并构造对象 #

直接在接口方法里接收参数列表，然后按顺序取对应的值构造Place对象：

public ResponseEntity find(@RequestParam String date,
                           @RequestParam List<String> country,
                           @RequestParam List<String> city) {
    // 先检查参数数量是否符合要求
    if (country.size() < 2 || city.size() < 2) {
        return ResponseEntity.badRequest().body("请提供出发地和目的地的国家、城市信息");
    }
    // 按顺序构造两个Place对象
    Place departure = new Place(country.get(0), city.get(0));
    Place arrival = new Place(country.get(1), city.get(1));
    // 业务逻辑处理
    return ResponseEntity.ok(Arrays.asList(departure, arrival));
}

这种方式简单直接，不需要额外配置，适合快速解决问题。

方式2：自定义参数解析器（优雅适配多个接口） #

如果多个接口都需要这种绑定逻辑，可以自定义Spring的参数解析器，让它自动处理：

1. 先创建一个包装类，用来承载两个Place对象：

public class PlacePair {
    private Place departure;
    private Place arrival;
    
    // 构造方法、getter、setter
    public PlacePair() {}
    public PlacePair(Place departure, Place arrival) {
        this.departure = departure;
        this.arrival = arrival;
    }
    // 省略getter和setter
}

2. 实现HandlerMethodArgumentResolver接口，编写自定义解析逻辑：

public class PlacePairArgumentResolver implements HandlerMethodArgumentResolver {
    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        // 只处理PlacePair类型的参数
        return parameter.getParameterType().equals(PlacePair.class);
    }

    @Override
    public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer, NativeWebRequest webRequest, WebDataBinderFactory binderFactory) throws Exception {
        // 获取请求中的country和city参数列表
        String[] countryArr = webRequest.getParameterValues("country");
        String[] cityArr = webRequest.getParameterValues("city");
        
        PlacePair pair = new PlacePair();
        // 按顺序分配参数到对应的Place对象
        if (countryArr != null && countryArr.length >= 1 && cityArr != null && cityArr.length >= 1) {
            pair.setDeparture(new Place(countryArr[0], cityArr[0]));
        }
        if (countryArr != null && countryArr.length >= 2 && cityArr != null && cityArr.length >= 2) {
            pair.setArrival(new Place(countryArr[1], cityArr[1]));
        }
        return pair;
    }
}

3. 把自定义解析器注册到Spring配置中：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        resolvers.add(new PlacePairArgumentResolver());
    }
}

4. 最后修改接口方法，直接使用PlacePair作为参数：

public ResponseEntity find(@RequestParam String date, PlacePair placePair) {
    Place departure = placePair.getDeparture();
    Place arrival = placePair.getArrival();
    // 业务逻辑处理
    return ResponseEntity.ok(Arrays.asList(departure, arrival));
}

这样你用原来的请求URL调用接口时，Spring就会自动把参数分配到对应的Place对象里，得到你想要的结果。

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