NextJS 12中Styled Components服务端渲染失效(首屏丢失CSS)
解决Next.js 12中Styled Components服务端渲染样式丢失问题
针对你遇到的首屏SSR丢失CSS样式的问题,可按以下步骤排查修复:
修正
next.config.js配置结构
你当前把reactStrictMode放在了compiler对象内,这是错误的配置位置,它应该和compiler同级。正确配置如下:module.exports = { reactStrictMode: true, compiler: { styledComponents: true, }, };移除旧版SSR兼容代码
如果你之前使用过styled-components的第三方插件,可能在_app.tsx/_app.jsx中存在手动处理SSR的代码(比如ServerStyleSheet、collectStyles等),请完全移除这些代码,Next.js 12+的内置编译器会自动处理SSR样式注入。确认Next.js版本
确保你的项目使用的是Next.js 12及以上版本,低于该版本的话内置编译器不支持Styled Components,需要回退到插件方案。清除缓存并重启服务
执行rm -rf .next清除Next.js缓存,然后重启开发服务器,避免旧配置缓存导致的问题。
内容的提问来源于stack exchange,提问作者pabloBar
相关产品推荐
相关产品推荐

