Skip to content

fix(admin): 公告发布时间改用 UTC 写入,修复线上显示偏 8 小时 - #333

Merged
Rosshow merged 1 commit into
dhualai:testfrom
Zhangjlfdf:admin-fix-announcement-published-at-utc
Oct 19, 2026
Merged

Rosshow merged 1 commit into
dhualai:testfrom
Zhangjlfdf:admin-fix-announcement-published-at-utc

Conversation

@Zhangjlfdf

Copy link
Copy Markdown
Collaborator

问题

生产公告「测试」真实发布时刻是 16:39(北京),但后台列表把它显示成次日 00:39,差 8 小时。

根因

published_at 用 datetime.now() 写入,取的是进程本地时间(生产容器 +08:00);
而项目的时区口径是全链路 UTC:

  • backend/app/core/db.py 的 _ensure_utc_session 把每个 DB 会话 time_zone 固定为 +00:00,因此 created_at/updated_at 的 func.now() 都是 UTC;
  • 前端 parseUtcDate 对无时区 ISO 串统一补 Z 当 UTC 解析,再转本地展示。

于是 published_at 存的是 +08 墙上时间、却被当 UTC 再 +8 小时 → 整体偏 8 小时。
同一条公告 created_at=08:39(UTC,正确)与 published_at=16:39(本地,错误)自相矛盾,即为实证。

改动

  • backend/app/modules/admin/api/announcement.py:新增 _utcnow()(datetime.now(timezone.utc).replace(tzinfo=None)),替换新建 / 编辑转发布 / 单独发布三处 datetime.now()。
  • backend/tests/test_announcement_api.py:补回归钉 _assert_is_utc,断言写入的 published_at 落在当前 UTC 时刻 ±120s 内(本地 +08 环境可稳定抓出旧写法;CI 为 UTC 时区不会误报)。

验证

  • pytest tests/test_announcement_api.py -q → 15 passed
  • 本机时区实测 local - utc = 8.0h,旧写法差值 28800s 必然触发断言

存量数据

生产库 announcements 仅 id=1 一条,published_at 需由 2026-10-19 16:39:29 回退为 2026-10-19 08:39:29(UTC),已单独处理。

published_at 原用 datetime.now()(进程本地时间,生产容器 +08:00),
而 app/core/db.py 已把 DB 会话时区固定为 +00:00、前端 parseUtcDate 又把
无时区 ISO 串统一按 UTC 解析再转本地,导致发布时间被多加 8 小时
(生产实测「发布于 16:39」显示成次日 00:39)。

改为 _utcnow() = datetime.now(timezone.utc).replace(tzinfo=None),
与 created_at/updated_at 的 func.now()(UTC 会话)口径一致;
新建/编辑转发布/单独发布三个入口统一收口。

测试补回归钉:新建与发布写出的 published_at 必须落在当前 UTC 时刻 ±120s
内(本地 +08 环境可稳定抓出旧的本地时间写法)。
@Rosshow
Rosshow merged commit 832b749 into dhualai:test Oct 19, 2026
2 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants