Thymeleaf实现多选表单时出现Required List参数‘state’不存在错误

架构老林

2026-5-25

解决Thymeleaf多选下拉表单参数缺失问题

这个问题我遇见过，核心原因是参数名不匹配加上模板代码不完整，咱们一步步来修复：

1. 修正参数名大小写不一致问题

你的Controller里接收参数用的是@RequestParam("state") List<String> states，但模板里下拉框的name属性写的是"State"（首字母大写）。Spring MVC对参数名是大小写敏感的，浏览器会提交名为State的参数，而Controller期望的是state，这就导致了Required List parameter 'state' is not present错误。

把模板里的下拉框name改成state：

<label for="State" class="label">State</label> 
<select id="State" name="state" data-name="State" class="w-select" multiple="multiple"> 
    <!-- 完整的option标签如下 -->
    <option th:each="s : ${states}" th:value="${s}" th:text="${s}"></option>
</select>

2. 补全Thymeleaf选项渲染逻辑

你原来的模板代码里option标签没写完，必须通过th:value指定选项的提交值，th:text指定页面显示文本，这样选中的选项才能正确传递给后端。

3. 验证表单提交配置

因为是普通POST表单提交，不需要额外设置enctype（默认的application/x-www-form-urlencoded即可），Spring MVC会自动把多个同名的state参数封装成List<String>。

修改后的Controller代码无需变动（只要参数名匹配即可）：

@PostMapping(value = "/employer/questionnaire") 
public String employerQuestionnaire(@RequestParam Map<String, String> body, 
                                   @RequestParam("state") List<String> states, 
                                   Model model){
    questionnaire.setStates(states);
    // 记得补充视图返回逻辑，比如：
    return "employer/questionnaire-result";
}