现象:生产环境所有站内跳转白屏,地址与标题已切换,刷新才恢复。
根因:AnimatePresence mode="wait" 要求新页等旧页退场完成才挂载;App Router
导航期间的重复渲染会重置退场完成标记,切换 state 的窗口被错过,
motion.div 永久停在 exit 变体(opacity:0; translateY(-8px))。
修法:路由内容只保留 key={pathname} 的 280ms 入场;首屏仍由 mounted 渲染
裸 children;reduce 变体改为显式可见终值,避免切到空变体时冻结在半透明。
守卫:新增 client-navigation-visibility(导航后落定再读祖先链乘积);
首屏用例改逐帧采样;视觉用例改逐屏滚动触发 whileInView。
验证:E2E 20/20(四浏览器)、视觉 125/125、单测 1815、type-check/lint 0 error。
Novalon Website 文档
欢迎来到Novalon Website项目文档中心。这里包含了项目的所有技术文档、开发指南和部署说明。
文档导航
📚 架构文档
💻 开发文档
🚀 部署文档
🧪 测试文档
🔌 API文档
📖 使用指南
项目概述
Novalon Website是四川睿新致远科技有限公司的企业官网,采用现代化的技术栈构建。
技术栈
- 框架: Next.js 16 + React 19
- 语言: TypeScript
- 样式: Tailwind CSS
- 数据库: SQLite + Drizzle ORM
- 认证: NextAuth.js
- 测试: Playwright + Jest
核心功能
- 企业展示和产品服务介绍
- 成功案例和新闻动态
- 在线咨询和联系表单
- CMS内容管理后台
- 响应式设计和SEO优化
快速链接
贡献指南
文档更新
- 确保文档内容准确、清晰
- 使用Markdown格式编写
- 添加必要的代码示例
- 更新相关链接和引用
文档审查
- 技术准确性
- 内容完整性
- 格式规范性
- 链接有效性
获取帮助
如果在使用过程中遇到问题,可以:
- 查看相关文档
- 搜索故障排查指南
- 联系开发团队
文档版本
- 版本: 1.0.0
- 更新日期: 2026-03-24
- 维护者: 开发团队
© 2026 四川睿新致远科技有限公司