Groovy中Date.plus()跨年度日期计算异常问题排查

看起来你遇到的是java.util.Date类本身的设计缺陷导致的跨年度日期计算错误——这个类其实已经被Java官方标记为过时了，它的内部日期处理逻辑很容易在跨月、跨年时出现异常，尤其是Groovy对它的plus(int)扩展方法，在某些情况下可能没有正确处理年份的进位。

为什么会跳回当年年初？ #

java.util.Date本质上是一个时间戳（毫秒数），但它的日期字段处理（比如年份、月份）存在历史遗留问题（比如年份是从1900开始偏移的）。当你调用plus(int)添加天数时，Groovy的扩展方法可能在计算过程中错误地重置了年份，导致跨年度的日期被错误地回滚到当年。而且这个问题不是必现的，只有当计算后的日期刚好跨年度时才会触发，这也解释了你循环1000次只出现18次异常的情况。

推荐解决方案：使用Java 8+的LocalDate #

Java 8引入的java.time包是专门为解决旧日期API的问题设计的，LocalDate是其中专门处理日期的类，不可变且线程安全，日期计算逻辑非常可靠。

修改后的代码如下：

import java.time.LocalDate
import java.time.temporal.ChronoUnit

LocalDate today = LocalDate.now()
def endRange = 1500
def randomInterval = new Random().nextInt(endRange)
LocalDate startDate = today.plus(randomInterval, ChronoUnit.DAYS)
LocalDate endDate = startDate.plusDays(5)

这个版本的代码会正确处理所有跨年度的情况，比如从12月30日添加5天，会自动计算到次年1月4日，绝对不会出现年份回滚的问题。

如果你必须使用java.util.Date（旧项目兼容） #

如果因为项目限制不能切换到新API，可以用Calendar类来处理日期加法，它的日期计算逻辑比直接用Date的plus方法更可靠：

Date today = new Date()
def endRange = 1500
def randomInterval = new Random().nextInt(endRange)

Calendar cal = Calendar.getInstance()
cal.setTime(today)
// 添加随机天数
cal.add(Calendar.DAY_OF_YEAR, randomInterval)
Date startDate = cal.getTime()
// 再添加5天
cal.add(Calendar.DAY_OF_YEAR, 5)
Date endDate = cal.getTime()

总结 #

java.util.Date和Calendar都是过时的API，官方推荐使用java.time包下的类来处理日期时间操作，不仅能避免这类奇怪的计算错误，代码可读性和维护性也更高。

内容的提问来源于stack exchange，提问作者Sireesha