What is the problem?
把 Next.js hydration error 当成前后端渲染结果不一致的问题来排查：先保存报错、复现路径和运行环境，再缩小到组件、数据和浏览器状态差异。
Quick solution
Treat this as a Node.js errors troubleshooting issue. First confirm the environment, inputs, permissions, logs, and delivery boundary. Then use the linked deep guide for the full checklist before changing production code or promising a result.
Read the deep guideDetailed steps
- 保存完整报错，不要只抄一句 “hydration failed”。把控制台、终端、页面路径和触发动作一起记录。
- 确认复现方式。分别测试首次打开、刷新、路由跳转、无痕窗口、本地开发环境和预览部署环境。
- 运行基础检查：`npm run build`、`npm run lint`、项目已有测试。先排除明显语法、类型或构建问题。
- 找最近改动。用 `git diff` 或提交记录看哪些组件、数据请求、布局、日期格式、主题切换或浏览器 API 被动过。
- 缩小到页面或组件。临时注释非关键区域时要保留记录，确认是哪一块移除后错误消失。
- 对比服务端初始内容和客户端内容。重点看日期、数字格式、条件渲染、用户状态、`window`、`localStorage`、媒体查询、第三方脚本。
Commands or code
Hydration 排查记录
页面路径：
首次发现时间：
是否本地可复现：
是否预览环境可复现：
是否刷新才出现：
是否路由跳转才出现：
完整控制台报错：
终端日志：
最近改动文件：
疑似组件：
已验证的排除项：
下一步要测试的最小复现：Risk notes
Confirm the real project environment, account permissions, platform rules, and output quality before delivery. Do not ship AI-generated changes without human review, and do not claim indexing, income, deployment success, or ranking improvements without measured evidence.