Django/Python修复offset-naive与offset-aware datetime比较报错

can't compare offset-naive and offset-aware datetimes 是Django时间处理的高频报错，本质是参与比较的两个datetime对象时区属性不匹配：

• 当Django配置中USE_TZ = True（默认开启）时，timezone.now()返回的是携带时区信息的offset-aware类型时间
• dateutil.parser.parse()解析时间字符串时，如果字符串本身没有携带时区标识（比如2024-06-01 12:00:00这种格式），返回的是不带任何时区信息的offset-naive类型时间
• Python不允许直接对这两种类型的时间做大小比较，就会抛出上述错误。另外原代码在字符串处理分支中，用未减去5小时的原始解析值wts_compare做时间判断，本身也存在逻辑偏差。

核心原则是把所有参与运算、比较的时间对象统一为相同时区类型，推荐对齐Django的默认逻辑，全部转成带时区的aware时间，避免跨时区场景下的计算错误，修复后代码如下：

from datetime import timedelta
from dateutil import parser
from django.utils import timezone

if not wts:
    raise ValueError('When to send(wts) is required')

# 提前取好比较基准时间，避免执行过程中时间差导致判断偏差
current_time = timezone.now()
# 读取Django配置的当前时区，作为naive时间的转换基准
current_tz = timezone.get_current_timezone()

if isinstance(wts, str):
    parsed_wts = parser.parse(wts)
    # 给无时区信息的解析结果补全时区
    if timezone.is_naive(parsed_wts):
        parsed_wts = timezone.make_aware(parsed_wts, current_tz)
    wts = parsed_wts - timedelta(hours=5)
else:
    # 兼容非字符串传入的naive时间，统一转成aware类型
    if timezone.is_naive(wts):
        wts = timezone.make_aware(wts, current_tz)
    wts = wts - timedelta(hours=5)

# 统一用偏移后的时间和当前时间做判断
if wts <= current_time:
    raise ValueError('when to send (wts) must be a future date-time')

• 类型判断优先用isinstance()替代type() is，可以兼容字符串子类的场景，鲁棒性更好
• 如果业务明确要求传入时间为固定时区（比如国内业务固定东八区），可以在timezone.make_aware()时直接指定对应时区对象，不需要读取Django默认时区
• 不要为了省事把timezone.now()转成naive时间去适配无信息的解析结果，这种写法在服务跨时区部署、用户跨时区访问时会出现大量时间计算偏差。

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