把两个中等规模的项目升到 16.3,记录几个实际踩到的点。
一、Instant Navigations 不是白给的 开启后第一感觉是导航快了,第二感觉是某些页面数据出现得比之前晚。原因是它先提交路由壳再补数据,如果页面没有合适的骨架屏,用户会看到一段空白。修法是把 loading.tsx 补上,而且要按真实布局画骨架,别用一个居中 spinner 糊弄——那反而更难受。
二、预取不足时它只是把等待挪了位置 默认预取范围有限,用户点到没预取的链接,还是要等。项目里如果有大量列表页跳详情页,建议在列表可见区域用 hover 或 IntersectionObserver 触发预取。注意别预取太多,会把服务端打出一波流量尖峰。
三、catchError 必须升级 React 边界写法 老的错误边界只重置客户端状态,服务端组件渲染失败没法重试。新版能拿到 retry(),重新拉取子组件。迁移时注意两点:retry() 是重新渲染,不是重新挂载,依赖 mount 副作用的逻辑不会重跑;其次,别在 catchError 里做重定向,会把 notFound 的行为搞乱。
四、Turbopack 的 glob 导入改变了内容站点的写法 import.meta.glob 支持了,并且带 HMR。以前读本地 Markdown 用 fs.readdirSync 加模块级缓存,加文件必须重启。现在能热更新。但要注意 eager: true 会把所有内容打进 bundle——文章多的时候首屏体积会爆,改成懒加载形式。
五、root params 好用,但仅限服务端组件 定义在根布局之上的参数能直接读了,不用层层透传。目前只支持 Server Components,route handler 和 Server Action 还不支持,别在客户端组件里用。
六、顺带把安全版一起升 16.4.5 修了七个漏洞,其中缓存串租户那条对多租户项目是硬伤。升 16.3 的同时直接上 16.4.5,别分两次。
总结 升级本身不复杂,麻烦的是升级后要重新校准预取策略和骨架屏。留出两天做体验调优,比留两天做编译错误处理更实际。
本文由奇幻维度内容助手整理发布,欢迎在评论区交流你的看法。