Python后端存储时间必须使用带timezone.utc的datetime对象，避免naive datetime导致跨系统错误；入库前统一转UTC，前端传ISO格式时间，API响应需按用户时区转换后再格式化，JSON序列化须确保输出UTC标准格式。
Python后端存时间必须用datetime带timezone.utc
不带时区的datetime对象（naive datetime）在跨系统、跨服务时极易出错，尤其和数据库交互或序列化为JSON时。Django、SQLAlchemy默认都倾向拒绝naive datetime写入；PostgreSQL的timestamptz字段也会静默按本地时区解释它，导致数据错位。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 所有入库前的时间，统一转成UTC时区：用
datetime.now(timezone.utc)或datetime.utcnow().replace(tzinfo=timezone.utc)（后者更安全，避免utcnow()返回naive对象） - 从数据库读出的
timestamptz，驱动（如psycopg2）通常已自动转为带timezone.utc的datetime，别手动再.astimezone(timezone.utc)——会重复转换 - 别用
time.time()或datetime.utcnow()直接存，它们不携带时区信息，后续无法可靠还原
前端传来的本地时间怎么安全转成UTC存库
前端JavaScript的Date.toString()或toISOString()默认含时区偏移，但用户可能手动改系统时区、或用new Date().toLocaleString()生成无偏移字符串——这类字符串进后端就是“裸时间”，含义模糊。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 强制前端用
new Date().toISOString()传时间（如"2024-05-20T08:30:00.123Z"），后端用datetime.fromisoformat()解析，它能正确识别Z并绑定timezone.utc - 若前端只能传无时区格式（如
"2024-05-20 08:30:00"），必须配套传timezone字段（如"Asia/Shanghai"），后端用zoneinfo.ZoneInfo定位并转UTC：dt.replace(tzinfo=ZoneInfo("Asia/Shanghai")).astimezone(timezone.utc) - 绝对别用
pytz的localize()处理用户输入时间——它假设输入是本地系统时区，而你根本不知道前端系统设的是什么
strftime输出给前端前，必须先astimezone()到用户时区
后端存储是UTC，但API响应里直接strftime一个UTC时间（比如"2024-05-20 08:30:00"）给前端，用户看到的就是UTC时间，不是他本地时间。用户永远只关心“我本地几点发生的”。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用户时区应由前端明确告知（如HTTP头
X-Timezone: Asia/Shanghai，或登录时存于用户profile），后端别猜 - 转换用
dt.astimezone(ZoneInfo(user_tz))，不是dt.replace(tzinfo=...)——后者只是硬塞时区，不改变时间值，会把UTC时间误标为上海时间 - 避免在模板或JSON序列化里直接调
strftime：先转好时区，再格式化。例如：dt.astimezone(ZoneInfo("Asia/Shanghai")).strftime("%Y-%m-%d %H:%M") - 注意
ZoneInfo在Python 3.9+才原生支持；老版本必须用pytz，但要用pytz.timezone("Asia/Shanghai").normalize(...)而非astimezone()，否则夏令时场景会出错
JSON序列化datetime时，default函数最容易漏掉时区检查
Django REST Framework或json.dumps默认不认datetime，常靠default参数转字符串。但若没判断是否带时区，naive datetime会被当成本地时间转ISO，结果变成错误的UTC偏移。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 写
default函数时第一行就检查：if isinstance(obj, datetime) and obj.tzinfo is None:，然后抛异常或打日志——宁可报错，也不静默存错 - 推荐统一用
obj.astimezone(timezone.utc).isoformat()输出，确保所有时间在JSON里都是UTC标准格式（如"2024-05-20T00:30:00+00:00"），前端再按需转本地 - 别用
obj.isoformat()直出：naive对象输出无+00:00，带时区对象却有，前端解析逻辑要分两路，容易漏处理
时区问题从来不在“怎么转”，而在“谁负责定义原始时间的上下文”。后端只信UTC，前端只管显示，中间那层协议（API字段含义、时区声明方式、错误反馈机制）才是最易崩的环节。
