SSR框架中实现window对象属性挂载的最佳实践

2025-06-29 09:50:44作者：傅爽业Veleda

在SSR(服务端渲染)应用开发中，我们经常需要在客户端全局对象window上挂载一些自定义属性或方法。这些属性可能包括应用配置、环境变量、用户信息等需要在客户端共享的数据。本文将详细介绍在SSR框架中实现这一需求的几种技术方案。

为什么需要在window上挂载属性

在SSR应用中，服务端和客户端需要共享某些数据时，将这些数据挂载到window对象上是常见的解决方案。这样做的主要优势包括：

数据可以在客户端任何地方访问
避免了重复的API请求
保持了服务端和客户端数据的一致性
方便第三方库或脚本访问这些数据

实现方案

方案一：通过layout组件注入script标签

在SSR框架中，最推荐的方式是通过layout组件生成script标签来注入全局变量。这种方法具有以下优点：

代码组织清晰，易于维护
可以充分利用SSR的特性
变量注入时机可控

实现示例：

// layout组件中
export default function Layout({ children }) {
  return (
    <html>
      <head>
        <script dangerouslySetInnerHTML={{
          __html: `window.__APP_CONFIG__ = ${JSON.stringify(config)}`
        }} />
      </head>
      <body>
        {children}
      </body>
    </html>
  )
}

方案二：服务端渲染时注入

在服务端渲染过程中，可以直接在HTML模板中注入script标签：

// 服务端渲染逻辑
const html = `
  <!DOCTYPE html>
  <html>
    <head>
      <script>
        window.__INITIAL_STATE__ = ${JSON.stringify(initialState)};
      </script>
    </head>
    <body>
      <div id="root">${content}</div>
    </body>
  </html>
`;

方案三：使用框架提供的API

某些SSR框架提供了专门的API来注入全局变量，这种方式更加规范和可控。例如：

// 使用框架API注入
app.useSSRContext(() => ({
  globals: {
    __APP_CONFIG__: config
  }
}));

注意事项

XSS防护：确保注入的数据经过适当的转义处理，防止XSS攻击
数据大小：避免在window上挂载过大的数据，影响页面性能
命名规范：使用特定的前缀(如__APP_*)避免与第三方库冲突
类型安全：在TypeScript项目中，需要扩展Window接口类型定义

最佳实践建议

优先使用框架提供的内置方法
将全局变量集中管理，避免分散在多处
考虑使用更现代的状态管理方案如Context API
对于敏感数据，考虑加密或仅在需要时注入

通过以上方法，开发者可以安全高效地在SSR应用中实现window对象的属性挂载，满足业务需求的同时保证应用的性能和安全性。

ssr

A most advanced ssr framework support React17/React18/Vue2/Vue3 on Earth that implemented serverless-side render specification.

项目地址：https://gitcode.com/gh_mirrors/ssr/ssr

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

docs

OpenHarmony documentation | OpenHarmony开发者文档

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

Java

gitea

喝着茶写代码！最易用的自托管一站式代码托管平台，包含Git托管，代码审查，团队协作，软件包和CI/CD。

ops-math

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统