Python — TypeError：无法比较 naive 与 aware datetime

症状

　　错误在一行里同时点名两个类别：TypeError: can’t compare offset-naive and offset-aware datetimes。给每个操作数打标签——tzinfo 为 None 即 naive，有 tzinfo 对象即 aware——混合群体就是病灶：不带时区类型的数据库列解析出 naive，而 API 客户端或带偏移的 fromisoformat 给出 aware 值。只有两种群体相遇的比较才会爆炸，所以部分记录排序正常、部分报错——错误是数据相关的而非代码路径相关的，这常让人误判为“时好时坏的 bug”。

诊断思路

　　先给操作数分类找到“异类”；再追溯产生来源：不带参数的 datetime.now()、不带 %z 的 strptime、utcfromtimestamp 都是 naive 工厂，fromisoformat 带偏移、now(timezone.utc) 是 aware 工厂；最后确认修复方向——全库 aware UTC 约定下，边界只需要 astimezone 一种转换。重构只给部分构造加了 timezone.utc 而漏掉其余，是渐进式引入混合的典型路径。

根因

　　带 tzinfo 的 datetime 携带比较与减法必须使用的偏移；naive datetime 没有，Python 无从得知两个操作数是否表达同一时刻。比较它们是有歧义的，datetime 选择抛 TypeError 而不是猜测——这比静默给出错误答案更好。

修复与验证

　　确立唯一约定：内部全程 aware UTC——构造用 now(timezone.utc)、解析后按文档语义显式挂 tzinfo、仅在展示层 astimezone 转本地时间；边界用 to_utc 归一化助手兜底，混合数据到不了比较代码。replace(tzinfo=utc) 那一步务必加注释写明“来源确为 UTC”的证据——给实际是本地时间的值挂 UTC 会静默平移时刻，比原来的 TypeError 更糟。验证时对含两种来源的数据集跑此前失败的排序与比较，断言零 TypeError 且结果与按 UTC 计算的参考一致。

代码示例

TypeError: can't compare offset-naive and offset-aware datetimes

for ts in [a, b, c]:
    print(ts, "naive" if ts.tzinfo is None else "aware")

from datetime import datetime, timezone

now = datetime.now(timezone.utc)          # never bare now()

# parsing a source that is documented as UTC:
ts = datetime.fromisoformat(value)
if ts.tzinfo is None:
    ts = ts.replace(tzinfo=timezone.utc)  # attach meaning explicitly

# display boundary only:
local = ts.astimezone()

def to_utc(ts: datetime) -> datetime:
    if ts.tzinfo is None:
        return ts.replace(tzinfo=timezone.utc)  # source is known UTC
    return ts.astimezone(timezone.utc)