React Native/Expo Router Suspense水合错误求助

问题描述 #

• 启动Expo开发服务器后，在浏览器localhost:8081打开应用时触发错误：Suspense边界在完成水合前收到更新，导致切换到客户端渲染
• 代码保存时应用内容显示正常，但每次刷新页面都会触发该错误
• Android端通过Expo Go运行应用完全正常，无任何类似错误

已尝试的解决方案 #

• 回滚项目版本至之前确认正常的提交
• 重新执行npm install确保依赖安装完整
• 手动清理项目缓存目录
• 使用expo start --clear命令重启开发服务器并清除缓存
• 更换Chrome、Firefox等不同浏览器测试
• 使用浏览器无痕模式访问应用

项目相关信息 #

Expo Router 项目结构 #

app/
  _layout.tsx
  index.tsx
  items.tsx

根_layout.tsx代码 #

// 粘贴根布局文件代码

items.tsx示例代码 #

// 粘贴items组件代码

package.json核心配置 #

{
  // 粘贴package.json中的依赖、脚本等核心配置
}

求助需求 #

目前无法定位问题根源，希望获得：

• 该水合错误的可能成因分析
• 进一步排查问题的具体方向或方法
• 可落地的修复方案

内容的提问来源于stack exchange，提问作者TallahasseeLasse