react 18+ · JavaScript
报错原文
Hydration failed because the initial UI does not match what was rendered on the server
这是什么意思
服务器发来的 HTML 与浏览器首次渲染出来的结果不一致，React 无法把两者对接。在渲染过程中用 new Date() 或 Math.random()、读 localStorage、按 window 宽度画不同的东西，都注定给出两个不同的答案；浏览器会悄悄纠正的标签也一样，比如 <p> 里套 <div>。规矩是：首次渲染要画出和服务器完全相同的东西，差异留到 useEffect 跑完之后再改。代价是那部分会晚一瞬间出现，并且不在服务器生成的 HTML 里。React 19 把同样的情形写作 "the server rendered HTML didn't match the client"，还会打印出哪里不一致的 diff。
怎么修
这个没有一行命令能解决。说明里写了该看哪里。
- 来自
- react 18+
- JavaScript
- 15
浏览器和 node 的错误通常只告诉你什么坏了，不告诉你那个值为什么变成这样——你读了 undefined、它不是函数、它不是 JSON——所以该修的地方在抛错那一行的上游；只用 ?. 和默认值把那一行按住，同样的问题会在更远的地方、以更难辨认的样子回来。
怎么读报错
- 从第一行往下读。越往下越是工具内部的事，起因通常写在最上面。
- 有文件名和行号就从那里查——不是栈顶那一帧，而是最上面那条提到你自己写的文件的行。
- 把报错原文照样去搜，但先去掉你自己的路径和变量名，正是那些让搜索匹配不上。
- 同一种情况在不同版本里措辞不同。结果不对头，就把版本号一起加进查询。
- 粘贴修法之前，先确认它会丢掉什么。这里面有些是不能撤回的。
常见问题
Q. “Hydration failed because the initial UI does not match what was rendered on the server” 是什么意思？
服务器发来的 HTML 与浏览器首次渲染出来的结果不一致，React 无法把两者对接。在渲染过程中用 new Date() 或 Math.random()、读 localStorage、按 window 宽度画不同的东西，都注定给出两个不同的答案；浏览器会悄悄纠正的标签也一样，比如 <p> 里套 <div>。规矩是：首次渲染要画出和服务器完全相同的东西，差异留到 useEffect 跑完之后再改。代价是那部分会晚一瞬间出现，并且不在服务器生成的 HTML 里。React 19 把同样的情形写作 "the server rendered HTML didn't match the client"，还会打印出哪里不一致的 diff。
Q. 怎么修？
没有一行命令能解决。上面的说明写了该看哪里。
Q. 这是哪个工具报的？
react 18+。它属于JavaScript，报错原文有 15 个词。