给 1 月 31 日加一个月

time.AddDate(0,1,0) 作用在 1 月 31 日上会归一化成 3 月 3 日——因为「2 月 31 日」不存在,Go 把多出来的天往后顺延。MySQL 的 DATE_ADD 则直接截断到 2 月 28 日。两种行为都有文档、单独看都算对,但用一层算边界、另一层算数据的报表,会在不报任何错的情况下差最多五天。

一个月度报表错了三天却不报错,比直接崩掉更糟。整件事两次运行就能讲完。

Go:四个日期,一个下午

for _, d := range []time.Time{
    time.Date(2026, 1, 31, 0, 0, 0, 0, time.UTC),
    time.Date(2026, 3, 31, 0, 0, 0, 0, time.UTC),
    time.Date(2026, 8, 31, 0, 0, 0, 0, time.UTC),
    time.Date(2024, 1, 31, 0, 0, 0, 0, time.UTC),
} {
    fmt.Printf("%s +1 -> %s\n", d.Format("2006-01-02"), d.AddDate(0, 1, 0).Format("2006-01-02"))
}
2026-01-31  +1 month -> 2026-03-03   (+2 months -> 2026-03-31)
2026-03-31  +1 month -> 2026-05-01   (+2 months -> 2026-05-31)
2026-08-31  +1 month -> 2026-10-01   (+2 months -> 2026-10-31)
2024-01-31  +1 month -> 2024-03-02   (+2 months -> 2024-03-31)

每一条都是 Go 在照文档办事:月份加一、日期不动、不存在的日期往后归一。1 月 31 日加一个月就是「2 月 31 日」,也就是 3 月 3 日;闰年是 3 月 2 日。

注意右边那列 +2:对这些日期它反而是对的。这个 bug 之所以能藏住,正是因为同一个函数在另一个偏移量上给出正确答案。

MySQL:同一个问题

SELECT DATE_ADD('2026-01-31', INTERVAL 1 MONTH) AS jan31_plus1,
       DATE_ADD('2026-03-31', INTERVAL 1 MONTH) AS mar31_plus1,
       LAST_DAY('2026-02-01')                    AS last_day_feb;
+-------------+-------------+--------------+
| jan31_plus1 | mar31_plus1 | last_day_feb |
+-------------+-------------+--------------+
| 2026-02-28  | 2026-04-30  | 2026-02-28   |
+-------------+-------------+--------------+

MySQL 选择截断:它不肯发明一个 2 月 31 日,直接落到当月最后一天。一个标准库加两个数据库方言,都在「加一个月」,1 月 31 日却映射出三个不同的日期——差别只取决于算术发生在哪一层。

它真实造成的故障

Go 算边界、SQL 过滤的报表:

now  := time.Date(2026, 3, 31, 10, 0, 0, 0, time.UTC)  // 「跑 3 月的报表」
from := now.AddDate(0, -1, 0)                          // 预期 2026-02-28,实得 2026-03-03
rows := db.Query("... WHERE created_at >= ? AND created_at < ?", from, now)
now             = 2026-03-31
AddDate(0,-1,0) = 2026-03-03   <- 报表实际用的窗口起点

代码算出的窗口是 [3 月 3 日, 3 月 31 日)——它默默丢掉了 3 月 1 日和 2 日,而且完全没覆盖 2 月。没有报错、没有空页面:一个少两天、看起来毫无异常的数值。

两层都安全的写法

y, m, _ := now.Date()
monthStart := time.Date(y, m, 1, 0, 0, 0, 0, now.Location())  // 2026-03-01
prevStart := monthStart.AddDate(0, -1, 0)                     // 2026-02-01
// 「上个月」窗口:[prevStart, monthStart)
monthStart   = 2026-03-01
prevStart    = 2026-02-01   <- 日期恒为 1,永不溢出

把日期钉到 1 号,等于从一开始就不让「2 月 31 日」这种输入出现——没有不存在的日期,就没有归一化。日期字段永远是 1,AddDate 重新变得无聊。

如果非要放在 SQL 里算,LAST_DAY() 就是那个 clamp,而且它和 MySQL 对 DATE_ADD 用的截断是同一个规则。

怎么知道它真的修好了

  • 测 31 号,别测 15 号。 只用月中日期的边界测试,上面四种实现全都能通过。把 2026-01-31、2026-03-31、2026-08-31、2024-01-31 写进用例。
  • 断言天数,而不是断言日期。 「1 月窗口 31 天、2 月 28 天」能同时抓住截断与溢出,且两个方向都管用。
  • 同一组用例在两层各跑一遍再 diff。 本文里这个差是 5 天(2026-02-28 对 2026-03-03);只要结果不是零,就是你的 bug——不管两层各自声称自己多正确。

怎么回滚

  • 已经生成过的报表:用截断规则重算,先把「逐日总数」比一遍再替换。边界挪三天会把收入从一个月份搬到另一个月份;直接覆盖旧数,等于销毁「搬了多少」的证据。
  • 落库的边界:如果持久化了算出来的 from/to,把原始时间戳一并存下来,这样以后修的时候是重算,不是猜。
  • 共享 helper 里的 AddDate:只改一处,但上线前必须 grep 所有调用点——同一个调用对 +2 months 是对的、对 +1 是错的,随手抽检会骗你。

常见问题

为什么 AddDate(0,1,0) 对 1 月 31 日返回 3 月 3 日?

因为它把月份加一、日期仍留 31。「2 月 31 日」不存在,Go 就往后归一到 3 月 3 日;闰年是 3 月 2 日。没有报错,也没有警告。

MySQL 也这样吗?

不。DATE_ADD 不认 31 号,直接截到当月最后一天:1 月 31 日加一个月是 2 月 28 日。所以同一条业务规则,在哪一层算,结果就不一样。

取「下个月的今天」安全写法是什么?

先把日期钉到当月 1 号,再加月份,最后按需 clamp 到 LAST_DAY。而且只在一层算——要么全在 Go,要么全在 SQL,绝不要拿 Go 算的边界去和 SQL 算的边界比。

哪个是对的?

没有绝对的对;截断更符合账期与报表习惯。问题不在选哪个,而在两层各选了一个、并且从没测过每个月的最后一天。

来源


本文最后一次核验:2026-11-18 · Go 输出来自 go1.27.0(Windows 11),SQL 输出来自 MySQL 8.4.13(Ubuntu 26.04 / WSL)。本页两段输出均原样粘贴,含闰年那一例。