Java 8 java.time API 使用需坚守四大原则：明确时区意图、区分时间概念、拒绝隐式默认、保持不可变性；禁用LocalDateTime表示真实时刻，避免依赖系统默认时区，弃用Date/SimpleDateFormat，数据库类型与Java类型须严格对应。
Java 8 引入的 java.time API 是一次重大改进，但很多开发者仍沿用旧习惯，或对新 API 理解不深，导致写出隐蔽、脆弱、跨环境出错的代码。避免反模式的关键不是“记住所有类”，而是守住几个核心原则：明确时区意图、区分时间概念、拒绝隐式默认、保持不可变性。
别把 LocalDateTime 当“真实时间”用
问题：用 LocalDateTime 存储、传输或持久化时间值——它不含时区，无法表示一个确定的时刻（instant）。
后果：不同服务器时区下解析结果不一致；存进数据库后查出来时间“漂移”；和前端/第三方系统对接时时间对不上。
正确做法：
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
立即学习“Java免费学习笔记（深入）”；
- 仅用于纯本地业务逻辑，比如“今天下午3点开会”，且不涉及跨时区协作
- 需要表示“某个确切时刻”时，统一使用
Instant（UTC 时间戳）或带时区的ZonedDateTime/OffsetDateTime - 入库前转成
Instant，读库后按需转为本地显示时间（如LocalDateTime.now(ZoneId.of("Asia/Shanghai"))）
别依赖系统默认时区（ZoneId.systemDefault()）
问题：在容器化、多环境部署场景中，systemDefault() 可能是 UTC（Docker 基础镜像）、CST（开发机）、或任意其他时区，导致同一段代码行为不一致。
后果：测试环境正常，生产环境时间偏移；定时任务漏执行或重复执行；日志时间混乱难排查。
正确做法：
立即学习“Java免费学习笔记（深入）”；
- 显式指定所需时区，例如
ZoneId.of("Asia/Shanghai")或ZoneOffset.UTC - 全局配置时区（如 JVM 启动参数
-Duser.timezone=Asia/Shanghai），但必须确保所有环境一致且受控 - 关键业务逻辑中，避免调用任何隐式依赖默认时区的方法（如
LocalDateTime.now()不带参数）
别用 SimpleDateFormat 或 Date 做新项目
问题：Date 和 SimpleDateFormat 是可变、非线程安全、设计混乱的遗留类，与 java.time 混用会引入转换歧义和隐藏 bug。
后果：格式化结果受线程干扰；Date.getTime() 返回毫秒数却常被误认为“本地时间”；与 Instant 转换时忽略时区含义。
正确做法：
立即学习“Java免费学习笔记（深入）”；
- 新代码彻底弃用
java.util.Date、Calendar、SimpleDateFormat - 格式化统一用
DateTimeFormatter（不可变、线程安全），例如：DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss").withZone(ZoneId.of("Asia/Shanghai")) - 必须兼容老接口时，只在边界做一次、有明确语义的转换，例如：
Instant.ofEpochMilli(date.getTime())（Date本质就是 UTC instant）
别在数据库字段类型和 Java 类型间随意映射
问题：MySQL 的 DATETIME 无时区，TIMESTAMP 存 UTC；PostgreSQL 的 timestamp without time zone vs with time zone 行为也不同。Java 层若不对应选择，就会“存进去是对的，取出来就错了”。
正确做法：
立即学习“Java免费学习笔记（深入）”；
- 数据库优先选带时区类型（如 PostgreSQL
timestamptz，MySQL 8.0+TIMESTAMP） - JDBC 层明确指定映射：用
OffsetDateTime对应TIMESTAMP，LocalDateTime仅对应DATETIME（且需文档注明“此字段按应用所在时区解释”） - JPA 中通过
@Convert或 Hibernate 的JavaTimeJdbcType统一处理，避免各处手写toString()/parse()
