Spring MVC List<Enum>绑定疑问：两种参数格式为何@Setter要求不同？

前端使用Axios时，默认会把数组参数序列化为arr[]=HELLO&arr[]=WORLD格式，这曾导致Spring Boot（嵌入式Tomcat）后端返回400错误。添加server.tomcat.relaxed-query-chars: ['[', ']', '{', '}']配置后解决了400问题，但又出现了新的异常。

请求DTO定义 #

@Getter
@AllArgsConstructor
@ToString
@ParameterObject
public class ExampleRequestDto {

    @Parameter(description = "example")
    private List<SomeEnum> arr;

}

现象描述 #

• 当前端发送GET /api/example?arr[]=HELLO&arr[]=WORLD请求时，后端日志显示ExampleRequestDto(arr=[HELLO])，仅第一个值被绑定，其余值被静默忽略，且无任何报错提示。
• 当请求改为GET /api/example?arr=HELLO&arr=WORLD格式时，无需给DTO添加@Setter注解，就能正常绑定所有值；给DTO添加@Setter后，arr[]=...格式也能正常绑定所有值。

疑问列表 #

1. 为何arr[]=HELLO&arr[]=WORLD格式需要@Setter才能正确绑定，而arr=HELLO&arr=WORLD格式不需要？
2. Spring在@ModelAttribute绑定过程中对这两种格式的解析是否存在差异？
3. 该行为是由Spring MVC内部绑定器还是Tomcat参数解析器导致的？
4. 为何值丢失时无异常或绑定错误提示，问题静默发生？

上下文环境：

• Spring Boot 3.2.x
• 嵌入式Tomcat
• 通过@ModelAttribute实现参数绑定
• 枚举值为HELLO、WORLD等标准值

问题解答 #

1. 两种格式对@Setter的依赖差异原因 #

Spring MVC处理arr=HELLO&arr=WORLD这种重复参数名的格式时，会直接将多个值注入到集合类型字段中——这种格式是Servlet规范默认支持的多值参数格式，Spring可以通过字段的构造器（你用了@AllArgsConstructor）直接完成集合的初始化与赋值，不需要Setter。

而arr[]=HELLO&arr[]=WORLD是类PHP风格的数组参数格式，Spring MVC需要通过索引式绑定逻辑处理：它会尝试先获取已存在的集合实例，再逐个添加元素。如果没有Setter，Spring无法修改已通过构造器初始化的集合（@Getter只提供读权限），只能把第一个值塞进初始集合，后续值因为无法修改集合而被丢弃。添加@Setter后，Spring可以通过Setter重新创建包含所有元素的集合并赋值给字段，因此能正确绑定所有值。

2. @ModelAttribute对两种格式的解析差异 #

是的，存在明显差异：

• 对于arr=HELLO&arr=WORLD：Spring MVC会将其识别为多值请求参数，直接调用request.getParameterValues("arr")获取所有值，再通过字段的构造器或Setter将这些值转换为集合。
• 对于arr[]=HELLO&arr[]=WORLD：Spring MVC会将其识别为带索引的参数绑定，先尝试实例化集合（如果字段未初始化），再逐个解析arr[]对应的参数值并添加到集合中。但如果集合是通过构造器初始化且没有Setter，Spring无法修改这个已存在的集合实例，只能保留第一个值。

3. 行为的根源 #

主要是Spring MVC内部的DataBinder绑定逻辑导致的，Tomcat仅负责基础的参数解析：

• Tomcat配置relaxed-query-chars后，只是允许[]作为合法查询字符，将arr[]作为参数名传递给Spring，不会处理参数的绑定逻辑。
• 真正处理参数到DTO绑定的是Spring MVC的ServletRequestDataBinder，它对两种参数格式的处理逻辑不同，才导致了最终的绑定差异。

4. 静默丢失值无报错的原因 #

Spring MVC默认绑定配置中，对于集合类型的绑定，当无法添加后续元素时（比如没有Setter无法修改集合），不会抛出异常——它认为这属于“部分绑定”的合法场景，而非错误。如果需要开启绑定错误提示，可以通过配置@InitBinder设置DataBinder的ignoreInvalidFields为false，或者添加@Validated注解配合全局异常处理器捕获绑定错误。

内容的提问来源于stack exchange，提问作者좋아감자탕