应使用ZonedDateTime结合ZoneId处理提醒时间，避免LocalDateTime无时区导致的偏差；用ScheduledExecutorService调度，基于Instant计算延迟；重复提醒用TemporalAdjusters而非Period；Android需改用AlarmManager或WorkManager。
用 LocalDateTime 和 ZoneId 做准确的提醒时间计算
Java 8+ 的 LocalDateTime 本身不含时区，直接用于提醒容易出错——比如用户在北京设置“明天上午9点提醒”，服务器在UTC时区解析就可能偏差8小时。必须搭配 ZoneId 转成 ZonedDateTime 才能正确处理夏令时、本地化偏移。
- 用户输入时间（如“2025-04-10T09:00”）先用
LocalDateTime.parse()解析，再通过atZone(ZoneId.systemDefault())绑定时区 - 若需跨时区推送（如海外用户），存储时统一转为
Instant，触发前再按用户当前ZoneId格式化显示 - 避免用
Date或Calendar：它们线程不安全，且Calendar.setTimeZone()在多线程下易被意外覆盖
用 ScheduledExecutorService 实现轻量级定时提醒
不需要引入 Quartz 或 Spring Scheduler 这类重型框架时，ScheduledExecutorService 是最直接的选择。它支持延迟执行和周期性调度，且可精确控制线程数与拒绝策略。
- 初始化推荐用
Executors.newScheduledThreadPool(3)，线程数不宜超过提醒并发峰值，防止资源耗尽 - 每次添加提醒任务，调用
schedule(Runnable, delay, TimeUnit)；delay 必须是Instant.now().until(nextTrigger, ChronoUnit.MILLIS)计算出的毫秒差 - 务必捕获
RuntimeException并记录日志——否则异常会静默吞掉任务，提醒彻底失效 - 不要用
Timer：单线程且无异常隔离，一个任务崩溃会导致后续全部丢失
处理重复提醒时绕开 Period 的陷阱
Period.ofDays(7) 看似适合“每周一提醒”，但它只操作日期字段，不考虑时区切换或夏令时跳变。比如某次触发刚好落在 DST 开始日（凌晨2点跳到3点），用 plus(Period) 可能漏掉当天或重复触发。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 重复逻辑应基于
ZonedDateTime+TemporalAdjusters：例如“每月第一个周一”用with(TemporalAdjusters.firstInMonth(DayOfWeek.MONDAY)) - 存储重复规则建议用字符串（如
"FREQ=WEEKLY;BYDAY=MO"），而非序列化Period对象——便于调试、迁移和前端解析 - 每次计算下次触发时间，都从上一次实际触发的
ZonedDateTime出发重新推导，不依赖固定间隔累加
Android 或桌面端触发提醒时注意 AlarmManager 与后台限制
纯 Java SE 环境下 ScheduledExecutorService 可靠，但移植到 Android 时，系统对后台服务和定时器有严格限制（尤其是 Android 8+）。直接用 ScheduledExecutorService 在应用退到后台后大概率被系统杀死。
立即学习“Java免费学习笔记（深入）”；
- Android 必须改用
AlarmManager.setExactAndAllowWhileIdle()（API 23+）或WorkManager（兼容低版本） - 桌面端若用 JavaFX，优先用
AnimationTimer配合时间比对，避免阻塞 UI 线程 - 所有提醒触发逻辑必须设计为幂等：同一事件可能被系统多次回调（如 AlarmManager 在低内存时重发）
真正难的不是算出下一次该什么时候提醒，而是确保这个“时候”在设备重启、时区变更、系统休眠唤醒后依然可靠。多数失败案例都卡在时区绑定时机不对，或者把 LocalDateTime 当成带时区的时间用了。
