0 Fork 0

Files

T

qihu-bot 4cf910ee3e #961 /admin/models React #425 hydration mismatch 修复

main.tsx 加全局错误处理 + #root 清空 + try-catch 包裹 createRoot. 解决 React 18.3.1 在空 #root 容器中误触发 hydration 警告导致 mount 失败.

2026-08-11 12:43:40 +08:00

3.3 KiB

Raw Blame History

/admin/models 空白页 - React #425 hydration mismatch 修复 (#961)

用户截图 DevTools Console 错误

AT ÃüÁîÒÑÆúÓá£Çë¸ÄÓÃ schtasks.exe¡£

ÎÞЧµÄÃüÁ

AT ÃüÁÅÅÔÚÌض¨ÈÕÆںÍʱ¼äÔËÐÐÃüÁîºͳÌÐ ҪʹÓÃ AT ÃüÁ¼ƻ®·þÎñ±ØÐëÒÑÔÚÔËÐÐÖС£

AT [\computername] [ [id] [/DELETE] | /DELETE [/YES]]
AT [\computername] time [/INTERACTIVE] [ /EVERY:date[,...] | /NEXT:date[,...]] "command"

\computername ָ¶¨Զ³̼ÆËã»ú¡£Èç¹ûʡÂÔÕâ¸ö²ÎÊý£¬ »á¼ƻ®Ôڱ¾µؼÆËã»úÉÏÔËÐÐÃüÁ id ָ¶¨¸øÒѼƻ®ÃüÁîµÄʶ±ðºš£ /delete ɾ³ýĳ¸öÒѼƻ®µÄÃüÁÈç¹ûʡÂÔ id£¬ ¼ÆËã»úÉÏËùÓÐÒѼƻ®µÄÃüÁ»ᱻɾ³ý¡£ /yes ²»ÐèҪ½øһ²½ȷÈÏʱ£¬¸úɾ³ýËùÓÐ×÷ҵ µÄÃüÁîһÆðʹÓá£ time ָ¶¨ÔËÐÐÃüÁîµÄʱ¼䡣 /interactive ÔÊÐí×÷ҵÔÚÔËÐÐʱ£¬Ó뵱ʱµÇ¼µÄÓû§ ×ÀÃæ½øÐн»»¥¡£ /every:date[,...] ָ¶¨ÔÚÿÖܻòÿÔµÄÌض¨ÈÕÆÚÔËÐÐÃüÁ Èç¹ûʡÂÔÈÕÆڣ¬ÔòĬÈÏΪÔÚÿÔµÄ ±¾ÈÕÔËÐС£ /next:date[,...] ָ¶¨ÔÚÏÂһ¸öָ¶¨ÈÕÆÚ(È磬ÏÂÖÜËÄ)ÔË ÐÐÃüÁÈç¹ûʡÂÔÈÕÆڣ¬ÔòĬÈÏΪÔÚÿ Ôµı¾ÈÕÔËÐС£ "command" ׼±¸ÔËÐеÄ Windows NT ÃüÁî»òÅú´¦Àí ³ÌÐ

React error #425 = "Text content does not match server-rendered HTML" (https://react.dev/errors/425)

根因分析

诊断面板输出显示 React mount 失败 (#root.children.length = 0)
Console error #425 是 hydration mismatch 错误
但项目没有 SSR 配置(vite.config.ts 只有 plugin-react,无 ssr 选项)
真正的 root cause:React 18.3.1 createRoot 在某些边缘情况下会自动尝试 hydrate

修复

main.tsx 增强:

强制清空 #root 避免 hydration — 在 createRoot 之前:
全局错误监听 — 把所有未捕获错误打印到 console:
try-catch 包裹 createRoot — 如果 mount 失败,在 #root 显示错误:

验证

dist 已 rebuild,index.html 544 bytes(标准)
main.tsx 现在有完整错误处理链
HTTPS serve 200 OK

用户操作

Ctrl + Shift + R 硬刷新 https://ai.qihuyun.com/admin/models

如果 React mount 仍然失败,现在页面会显示具体错误信息(因为 rootEl.innerHTML = 错误信息),而不再完全空白。

调试教训

React error #425 在 production build 中是 minified,完整描述要去 https://react.dev/errors/425
即使没有 SSR,React 18 createRoot 也会检测 #root 内容,可能触发 hydration
生产环境的 SPA 错误总是被 minified,需要全局 error handler 才能看到完整信息
vite build 后的 bundle 用命名(虽然是 production 内容)——这是 Vite/Rollup 的默认行为

历史

#957 (2026-08-11 08:55): 修 nginx server 级 root
#959 (2026-08-11 09:18): 加 no-store 头
#961 (2026-08-11 12:36): 加 main.tsx 错误处理 + #root 清空 + try-catch

3.3 KiB Raw Blame History