Spring Boot中如何将两个请求参数名绑定到同一控制器方法参数？

可以实现，以下是几个可行的方案：

这是最灵活的方案，适合需要在多个控制器复用多别名参数绑定的场景。

• 第一步：自定义注解标记需要多别名的参数

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
public @interface MultiRequestParam {
    String[] value();
}

• 第二步：实现参数解析逻辑

@Component
public class MultiRequestParamResolver implements HandlerMethodArgumentResolver {
    @Override
    public boolean supportsParameter(MethodParameter parameter) {
        return parameter.hasParameterAnnotation(MultiRequestParam.class);
    }

    @Override
    public Object resolveArgument(MethodParameter parameter, ModelAndViewContainer mavContainer, NativeWebRequest webRequest, WebDataBinderFactory binderFactory) throws Exception {
        MultiRequestParam annotation = parameter.getParameterAnnotation(MultiRequestParam.class);
        String[] paramNames = annotation.value();
        
        // 依次尝试获取参数值
        for (String paramName : paramNames) {
            String paramValue = webRequest.getParameter(paramName);
            if (paramValue != null) {
                // 适配Long类型转换，其他类型可扩展处理
                return Long.parseLong(paramValue);
            }
        }
        return null; // 无匹配参数时返回null，可根据需求调整默认值
    }
}

• 第三步：注册解析器到Spring MVC配置

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Autowired
    private MultiRequestParamResolver multiRequestParamResolver;

    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> resolvers) {
        resolvers.add(multiRequestParamResolver);
    }
}

• 第四步：控制器方法中使用

@GetMapping("/api/test")
public ResponseEntity<String> test(@MultiRequestParam({"test1", "test2"}) Long param) {
    return ResponseEntity.ok("test succeeded! param : " + param);
}

适合单个控制器或少量参数的轻量场景，无需额外配置类。

@RestController
public class TestController {
    @InitBinder
    public void initBinder(WebDataBinder binder, HttpServletRequest request) {
        String test1 = request.getParameter("test1");
        String test2 = request.getParameter("test2");
        
        // 优先取test1，不存在则取test2
        String targetValue = test1 != null ? test1 : test2;
        if (targetValue != null) {
            binder.bind(new MutablePropertyValues(Collections.singletonMap("param", targetValue)));
        }
    }

    @GetMapping("/api/test")
    public ResponseEntity<String> test(Long param) {
        return ResponseEntity.ok("test succeeded! param : " + param);
    }
}

利用@RequestParam的SpEL支持，直接在注解中处理参数优先级，代码最简洁。

@GetMapping("/api/test")
public ResponseEntity<String> test(
        @RequestParam(value = "#{request.getParameter('test1') ?: request.getParameter('test2')}") Long param) {
    return ResponseEntity.ok("test succeeded! param : " + param);
}

注：如果参数类型复杂，可能需要手动处理类型转换，可读性相对前两种方案稍弱。

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