@InitBinder用于注册PropertyEditor或Converter以解析日期字符串，在控制器中定义void型方法配置WebDataBinder，支持SimpleDateFormat（需注意线程安全）或Converter（推荐用于LocalDate等），作用范围限于本类，全局配置需用WebMvcConfigurer。
在 Spring MVC 中，@InitBinder 注解用于注册自定义的 PropertyEditor 或 Converter，从而让控制器能正确解析请求中的日期字符串（如 2024-03-15）为 java.util.Date、LocalDate 等类型。
在控制器中定义 @InitBinder 方法
该方法必须是 void 返回类型，参数为 WebDataBinder，且需标注 @InitBinder。它会在每次请求前自动执行，为当前控制器的所有 handler 方法统一配置数据绑定规则。
- 方法不能是
static，也不能有返回值 - 通常放在
@Controller类中，作用范围仅限本类（若想全局生效，需用@Configuration+WebMvcConfigurer） - 可指定
value属性，限制只对特定参数名生效（较少用）
注册 SimpleDateFormat 处理 java.util.Date
适用于 Date 类型入参。注意线程安全问题：SimpleDateFormat 不是线程安全的，因此每次绑定都应新建实例，或使用 ThreadLocal 封装 —— 但 WebDataBinder 内部已做隔离，直接 new 是安全的。
@InitBinder
public void initBinder(WebDataBinder binder) {
SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd");
dateFormat.setLenient(false); // 严格校验，如 2024-02-30 会报错
binder.registerCustomEditor(Date.class, new CustomDateEditor(dateFormat, true));
}
这样，当 controller 方法形如 public String handle(@RequestParam Date date) 时，传入 ?date=2024-03-15 就能成功绑定。
注册 Converter 处理 LocalDate / LocalDateTime
推荐使用 Converter（尤其是 Java 8+ 时间 API），更灵活、线程安全，且支持全局复用。
- 先定义转换器（实现
Converter<String, LocalDate>） - 在
@InitBinder方法中通过binder.addCustomFormatter(...)注册
示例：
@InitBinder
public void initBinder(WebDataBinder binder) {
DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd");
binder.addCustomFormatter(new DateFormatter(formatter), LocalDate.class);
DateTimeFormatter dtFormatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
binder.addCustomFormatter(new DateFormatter(dtFormatter), LocalDateTime.class);
}
此时方法参数可直接写 @RequestParam LocalDate date，Spring 会自动调用对应 formatter 解析。
注意事项与常见问题
绑定失败时，Spring 默认抛出 MethodArgumentTypeMismatchException，前端收到 400 错误。可通过 @ExceptionHandler 统一处理，或启用 @Valid 配合 @DateTimeFormat 注解简化单个参数配置。
-
@DateTimeFormat(pattern = "yyyy-MM-dd")可直接加在 Controller 参数上，比@InitBinder更轻量，适合局部使用 - 如果用了
@InitBinder却仍报错，检查日期格式是否与传入字符串完全匹配（如多空格、时区、大小写） - 全局日期绑定建议在配置类中实现
WebMvcConfigurer.addFormatters()，避免每个 Controller 重复写
