一个Python的datetime对象，序列化后还能和原对象比较相等，但等到工作流跨过夏令时边界时，行为却完全变了。这不是崩溃，不是报错，序列化器成功执行，时间戳也完好无损——消失的是IANA时区规则和fold位。
这个坑就藏在LangGraph的检查点机制里。有人在LangGraph上游commit 81bf17b23上复现了这个问题，用的是langgraph-checkpoint 4.2.0的元数据。问题不在崩溃，而在于：序列化成功了，瞬间也保留了，但时区规则丢了。
最小复现：一个看似正常的往返测试
复现条件很简单：Python 3.10，JsonPlusSerializer，不涉及模型调用、数据库或LangSmith。核心代码就几行：
before_tz = zoneinfo.ZoneInfo(key='America/New_York')after_tz = datetime.timezone(... -05:00)equal = Truebefore_plus1 = 2026-03-08 09:00:00-04:00after_plus1 = 2026-03-08 10:00:00-04:00fold = 1 -> 0
结果明确标注：REPRODUCED。equal=True恰恰是问题所在——一个固定的UTC-05:00偏移量可以表示与ZoneInfo("America/New_York")相同的瞬间，但它不知道纽约第二天会切换到UTC-04:00。
为什么加一天会差一小时
测试用例从2026年3月7日纽约时间上午9点开始，跨过春季夏令时转换加一天。序列化之前，墙上时钟保持在09:00。恢复之后，固定偏移的datetime产生的是10:00。
这个差异对提醒、预约、市场时间表、账单截止日期和长时间运行的agent例程都有实际影响。如果存的是UTC的绝对事件，暴露风险就小得多。
fold是独立的状态位
Python的fold用于区分时钟回拨时模糊本地时间的两个副本。在同一个往返过程中，fold=1变成了fold=0。因此，一个稳健的回归测试不能只检查相等性：
assert getattr(restored.tzinfo, "key", None) == "America/New_York"assert restored.fold == before.foldassert restored + timedelta(days=1) == expected_local_time_next_day
本地通过的临时方案
在上游修复版本在你的技术栈中经过回归测试之前，可以显式持久化时区语义：
payload = {"instant": value,"zone": "America/New_York","fold": value.fold,
恢复后用ZoneInfo重建。测试结果显示：restored_tz=zoneinfo.ZoneInfo(key='America/New_York')，next_day=2026-03-08 09:00:00-04:00，CONTAINMENT_OK。
这是应用层面的隔离方案，不是LangGraph上游的修复。如果原始时区从未存储过，就无法从旧的固定偏移量重建IANA时区。
实用规则
绝对事件用UTC存储。对于有本地时间含义的日程，显式持久化IANA时区键，在模糊时间重要时保留fold，并在检查点回归测试中加入跨夏令时的算术验证。
复现代码在github.com/xbstack/langgraph-zoneinfo-fold-checkpoint-repro，原始文章来自XBSTACK。
热门跟贴