Python 3.10.9 的接口收到前端 toISOString() 生成的时间,形如 2026-11-11T02:30:00.000Z,交给 datetime.fromisoformat 直接抛 ValueError: Invalid isoformat string。这个格式在浏览器里是标准输出,在 3.10 的标准库里却不认结尾的 Z。
我第一反应是让前端改成 +00:00 再发。前端试了一圈回来说 iOS 的 toISOString 固定输出 Z,改不了。也试过 strptime 配 %Y-%m-%dT%H:%M:%S.%fZ,碰到没有毫秒的字符串又失败,最后写成两套格式 try/exCept,代码很难看。
换成先把结尾的 Z 换成 +00:00,再交给 fromisoformat。3.10 支持带冒号的时区偏移,解析出来是 aware datetime,直接存库会带上时区,MySQL 的 datetime 字段会把它悄悄转成会话时区,差 8 小时。
所以入库前统一 astimezone(timezone.utc) 再 replace(tzinfo=None),存的是 UTC 的裸时间;展示层再转到本地时区。这套约定写进了项目的基础工具类,业务代码不许自己调 fromisoformat。
还有一个边界,字符串中间也可能出现别的时区写法,比如 +0800 没有冒号,3.10 同样解析不了。判断只处理结尾的 Z,其他格式走正则补冒号,别用全局 replace 把正文里的字母也换掉。
时区这块还踩过一次,容器里的 TZ 没设,datetime.now() 取到的是 UTC,日志时间比北京时间慢 8 小时。后来统一用带时区参数的 now,展示层再转,代码里禁止无参调用。数据库连接串里也加了时区参数,驱动不会再按本机时区解释。两处都改完,跨时区部署的三个机房时间才对齐。这条约定后来写进了项目模板,新服务直接继承,省得每次都要解释。这条也写进了模板。
解析函数最后包了一层 try,遇到非法字符串返回空值并记录原始值,别让一条脏数据把整批任务打断。
确认口径:2000 条线上样本全部解析成功,跨零点的那批记录时间差为 0;数据库里的时间和 UTC 时钟比对误差在 1 秒内;前端回显的本地时间正确。
if s.endswith("Z"):
s = s[:-1] + "+00:00"
dt = datetime.fromisoformat(s)
dt = dt.astimezone(timezone.utc).replace(tzinfo=None) 