LocalDate 不能直接替代 Date，因二者类型不兼容：LocalDate 仅含年月日，Date 含时分秒及时区；强行替换易引发 ClassCastException 或 DateTimeException。
LocalDate 不能直接替代 Date，因为类型不兼容
Java 的 LocalDate 和 Date 根本不是一回事：前者只存年月日，后者带时分秒和时区信息。强行用 LocalDate 去“替换” Date，八成会在解析、序列化或数据库交互时抛 ClassCastException 或 DateTimeException。
常见错误现象：
- 把
new Date()直接强转成LocalDate—— 编译都不过 - 用
LocalDate.now()存进老项目里期待 JPA 自动映射到java.util.Date字段 —— 插入 null 或报IllegalArgumentException - 调用
date.toInstant()后没指定时区就转LocalDate—— 结果错一天（尤其在东八区深夜）
实操建议：
- 新代码统一用
LocalDate处理纯日期逻辑（如生日、合同生效日） - 涉及时间戳、HTTP 请求头、数据库
DATETIME字段，优先用Instant或ZonedDateTime - 和旧代码桥接时，用
date.toInstant().atZone(ZoneId.systemDefault()).toLocalDate()，别漏atZone
parse() 方法默认只认 "yyyy-MM-dd"，其他格式要显式传 DateTimeFormatter
LocalDate.parse("2024/05/20") 会直接抛 DateTimeParseException，不是它“不支持斜杠”，而是默认解析器只认 ISO_LOCAL_DATE（即 "2024-05-20"）。
立即学习“Java免费学习笔记（深入）”；
使用场景：
- 前端传来的日期字符串格式不统一（
"2024.05.20"、"20240520"、"20-May-2024"） - 读取 Excel 或 CSV 里没有标准化的日期列
实操建议：
- 固定格式用预定义常量：
LocalDate.parse("20240520", DateTimeFormatter.BASIC_ISO_DATE) - 自定义格式必须显式传：
LocalDate.parse("2024/05/20", DateTimeFormatter.ofPattern("yyyy/MM/dd")) - 别复用
DateTimeFormatter实例做并发解析——它是线程安全的，但别在循环里反复 new
plusDays() / minusMonths() 等方法返回新对象，原值不变
LocalDate 是不可变类，所有“修改”操作都返回新实例。写 date.plusDays(1); 而不赋值，等于什么都没干。
常见错误现象：
- 在 if 判断里调用
date.plusDays(1).isAfter(other)，以为改了date，结果后续逻辑仍用原值 - for 循环中写
current.plusDays(1)却没更新current变量，死循环
实操建议：
- 每次运算后必须重新赋值：
date = date.plusMonths(3); - 链式调用没问题：
date.plusYears(1).minusDays(5).withDayOfMonth(1) - 需要连续偏移时，优先用
Period：date.plus(Period.ofMonths(2).plusDays(7))，语义更清晰
和 MySQL 的 DATE 类型交互要注意 JDBC 驱动版本
JDBC 4.2+ 才原生支持 LocalDate；用低版本驱动（比如 mysql-connector-java 5.1.x）调 PreparedStatement.setObject(1, localDate)，会默默转成字符串再入库，可能触发隐式类型转换或截断。
性能与兼容性影响：
- 驱动 ResultSet.getObject("col", LocalDate.class) 可能返回 null（即使数据库有值）
- Spring Boot 2.1+ 默认带高版本驱动，但若手动排除了
spring-boot-starter-jdbc，容易踩坑
实操建议：
- 检查依赖树：
./gradlew dependencies | grep mysql，确认是 8.0.33+ 或 mariadb-java-client 3.0+ - MyBatis 中用
@Options(useGeneratedKeys = true)时，确保resultType或resultMap显式声明字段为LocalDate - Hibernate 用户注意：
@Column(columnDefinition = "DATE")+@Convert(converter = LocalDateConverter.class)在老版本里仍是稳妥做法
最容易被忽略的是跨时区服务器部署：数据库设在 UTC，应用跑在 CST，LocalDate.now() 拿到的是系统时区的“今天”，但存进数据库后查出来可能变成昨天——因为 JDBC 驱动底层仍按 java.time 规则处理时区上下文。
