release: reduce hydration 修复 + §16 排查记录 #48

Merged
zhangxiang merged 2 commits from dev into main 2026-10-20 08:03:29 +08:00
2 Commits
Author SHA1 Message Date
zhangxiang c394347dd0 docs(qa): §16.5 修复上线与线上 reduce 实测(hidden 14→3、0 hydration 错误)
同时登记本轮的编排事故:第一次重传用 set -- $pair 分词,zsh 不分词 ⇒ 5 条 rsync 全失败,
但未开 set -e 仍继续 docker build,等于用旧文件重建了一次镜像(无可见症状)。
已改为逐条判退出码重传并重建,用 BUILD_ID 与 reduce 实测确认线上确是新代码。
教训同 §5.44:命令都返回了 ≠ 命令都成功了。
2026-10-20 08:03:14 +08:00
zhangxiang d0090cea56 fix(motion): reduce 偏好下 hydration 不匹配(React #418)且元素停在 opacity:0
线上 /about 白屏排查(§16):30 条路由 + 6 种环境里唯一可复现的缺陷是
webkit/chromium + prefers-reduced-motion:reduce ⇒ pageerror #418,main 内 14 个元素
opacity 恒 0(正常环境只有 3 个首屏以下的滚动入场项)。

根因:useReducedMotion 用 window.matchMedia 作 useState 初值 ⇒ SSR false、客户端首帧 true;
scroll-reveal / template / page-transition 又用它决定 initial/variants/甚至早返回不同树结构,
与 SSR HTML 不一致;且 reduce 时 whileInView 被清空 ⇒ 元素停在 initial 的 opacity:0。

修法(结构恒定,减少动效改用「时长 0」表达):
- hook 首帧恒 false,挂载后 effect 同步真实偏好;
- ScrollReveal/StaggerReveal 的 initial/whileInView/variants 不再按 reduce 清空;
- template.tsx 与 StaggerChildren 去掉早返回裸结构,改空 variants。

回归守卫 e2e/reduced-motion-hydration.spec.ts(/about 与 /):断言 reduce 自证生效、
无 hydration 错误、h1 与末段标题 opacity=1。变异验证:hook 改回 matchMedia 初值 ⇒ 2 红,恢复 ⇒ 2 绿。

另:runbook 明确禁止对 dist/_next/static 用 --delete(回访者旧 HTML 会引用上一代 chunk);
本轮已从备份 --ignore-existing 合并回旧代 101 个文件。复算:tsc/type-check:e2e 0、
jest 35 套件 462 例 0、check:visual 0、check:motion 0、视觉 chromium-desktop 25/25。
2026-10-20 08:00:20 +08:00