SSR下styled-components闪屏主因是ServerStyleSheet复用、collectStyles未包裹全树、客户端class名不一致及未调用seal()。须每次请求新建sheet、完整包裹App、严格同步theme、生产环境设NODE_ENV、及时seal释放内存。
服务端渲染（SSR）下 styled-components 闪屏，根本不是“样式没加载完”，而是服务端压根没把样式塞进 HTML 字符串里——ServerStyleSheet 用错一次，首屏就闪。
ServerStyleSheet 必须每次请求新建实例
复用 ServerStyleSheet 实例是 SSR 闪屏最常见原因。Node.js 服务器通常是长生命周期进程，若在模块顶层或中间件外创建 sheet，它会被多个请求共享，导致 collectStyles 报错 Can't collect styles once you've consumed，且后续请求完全不生成样式。
- ✅ 正确：在每次 SSR 渲染函数内初始化：
const sheet = new ServerStyleSheet() - ❌ 错误：在文件顶部声明
const sheet = new ServerStyleSheet()，然后到处 import 使用 - ⚠️ 注意：Next.js Pages Router 的
getInitialProps、Express 中的res.render回调、或自定义 render 函数，都属于“每次请求”上下文
必须 collectStyles 包裹整个 App 树，且插入 getStyleTags() 到 HTML
collectStyles 不是装饰单个组件的工具，它是一个收集器——只有被它包裹的 React 元素树中实际渲染的 styled 组件，其样式才会被捕获。漏掉任意一层（比如忘了包 <app></app>，只包了某个子组件），对应样式就永远不会出现在服务端输出中。
- ✅ 正确写法：
sheet.collectStyles(<app></app>)，确保<app></app>是顶层入口组件 - ✅
sheet.getStyleTags()必须作为字符串插入最终 HTML 的<head>内，不能丢弃、不能插错位置（如插到<body>底部） - ⚠️ Next.js App Router 场景下，
ServerStyleSheet基本不可用——它不兼容 React Server Components 的流式渲染模型；此时应改用@emotion/server或放弃 styled-components
客户端 hydration 前 class 名必须严格一致
服务端吐出的 class 名（如 sc-aBvKx bXQqJF）和客户端 JS 执行后生成的 class 名只要有一个字符不同，React 就判定 DOM 不匹配，跳过样式复用，强制重绘——FOUC 立刻发生。
立即学习“前端免费学习笔记（深入）”；
- ✅ 确保服务端和客户端使用**完全相同版本**的
styled-components（检查package-lock.json中是否混用 v5/v6） - ✅ 生产环境必须设
process.env.NODE_ENV = 'production'，否则服务端不 hash class 名，客户端却按 hash 规则找，必然失败 - ✅ theme 对象必须在服务端完整传入（不能依赖
useEffect或 localStorage 读取），动态插值如color: ${p => p.theme.primary}在服务端无 theme 时会产出空规则或默认值，class 名与客户端不一致 - ⚠️ 微前端或多子应用共用 styled-components 实例时，各应用版本不统一极易触发此类问题——没有运行时隔离机制
seal() 不只是可选，它是内存安全的硬性要求
sheet.seal() 不仅是为了防止重复调用 collectStyles，更关键的是释放内部引用。不调用它，sheet 实例会持续持有对组件树的引用，造成内存泄漏；更严重的是，下次请求再用同一个实例（哪怕你新建了）也可能因内部状态残留而报错或静默失效。
- ✅ 必须放在
try/finally块中调用，确保无论渲染成功或抛错都会执行 - ✅ Next.js Pages Router 示例中，
getInitialProps返回前、Expressres.send前，都必须 seal - ⚠️ 漏掉
seal()后，错误往往延迟暴露：可能表现为某次部署后突然闪屏，但日志里找不到明确报错
最容易被忽略的其实是 theme 同步和 seal() 的执行时机——它们不报错，但会让 FOUC 变得不可预测。一旦发现闪屏，先确认这两点，比查网络请求或 CSS 文件顺序更有效。
