Spring Boot Thymeleaf表单如何仅选择年月并正确绑定到LocalDate类型字段

看起来你遇到的核心问题是：原生HTML的date类型input会强制选择完整日期（带日），提交的格式是yyyy-MM-dd，但你的DTO里要求用MM-yyyy格式解析，这就导致Spring无法完成字符串到LocalDate的类型转换，抛出了BindException对吧？我来给你一步步解决这个问题：

第一步：替换前端输入控件为年月选择器 #

原生HTML5提供了专门的年月选择器，把input的type从date改成month就行。这个类型的控件会弹出仅选择年月的界面，提交的格式是yyyy-MM（不带日），完美符合我们的需求。

修改你的Thymeleaf片段：

<span th:fragment="choose-look-date">
  <form method="post" th:object="${datePicker}">
    <div>
      <label for="choose-look-date">Choose the date:</label>
      <!-- 把type改成month，同时调整格式化格式为yyyy-MM，对应控件的value要求 -->
      <input type="month" name="lookDate" th:value="${#temporals.format(datePicker.lookDate, datePicker.dateFormat)}" id="choose-look-date"/>
    </div>
    <div>
      <button type="submit" class="button">Submit</button>
    </div>
  </form>
</span>

第二步：调整DTO的日期格式配置 #

现在前端提交的是yyyy-MM格式的字符串，我们需要同步修改DTO的@DateTimeFormat的pattern，同时保证Thymeleaf格式化时输出的字符串能被month控件识别：

@Data
public class DatePickerDto implements Serializable {
    // 匹配前端提交的yyyy-MM格式，Spring会自动补全日为当月第一天
    @DateTimeFormat(pattern = "yyyy-MM")
    private LocalDate lookDate;

    // 同步修改格式字符串为yyyy-MM，对应前端month控件的value要求
    private String dateFormat = "yyyy-MM";
}

可选：自定义日期转换器（防止特殊场景转换失败） #

如果Spring默认的日期转换器在解析yyyy-MM到LocalDate时出现问题（比如某些版本的Spring Boot可能需要显式指定补全日的逻辑），可以在Controller里注册一个自定义转换器：

@Controller
public class YourController {

    @InitBinder
    public void initDatePickerBinder(WebDataBinder binder) {
        DateTimeFormatter monthFormatter = DateTimeFormatter.ofPattern("yyyy-MM");
        binder.registerCustomEditor(LocalDate.class, new PropertyEditorSupport() {
            @Override
            public void setAsText(String text) throws IllegalArgumentException {
                if (text != null && !text.isBlank()) {
                    // 把yyyy-MM字符串拼接上"-01"，转成LocalDate（当月第一天）
                    setValue(LocalDate.parse(text + "-01", DateTimeFormatter.ISO_LOCAL_DATE));
                } else {
                    setValue(null);
                }
            }
        });
    }

    // 你的请求映射方法...
}

为什么原来的代码会报错？ #

你之前用type="date"的input，无论怎么设置DTO的格式，用户选择时都会带上具体日期（比如2025-07-22），而DTO的@DateTimeFormat(pattern = "MM-yyyy")只能解析MM-yyyy格式的字符串，Spring没法把2025-07-22转换成符合要求的LocalDate，所以就抛出了类型不匹配的绑定异常。

现在这样修改后，前端只会提交年月（yyyy-MM），后端也能正确解析成LocalDate（默认或手动补全为当月第一天），就能正常绑定了！

内容来源于stack exchange