react 服务器端渲染 ssr 中 localstorage/history/window is not defined 解决方案

最新推荐文章于 2025-06-03 13:53:29 发布

原创最新推荐文章于 2025-06-03 13:53:29 发布 · 3.2k 阅读

CC 4.0 BY-SA版权

本文探讨了服务器端渲染(SSR)过程中遇到的问题，即在服务器环境中尝试访问浏览器特有属性(如window和localStorage)时引发的错误，并提供了一种解决方案：通过使用ES6的Proxy来代理这些浏览器属性，确保在SSR环境下也能正常运行。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1、原因

　ssr 会在后端执行组件的 componentWillMount 以及在它这个生命周期之前的生命周期

也就是说 ssr 阶段是不会执行 componentDidMount 方法的

　当你在 componentWillMount 之前当生命周期里面调用 window / localstorage 全局对象的时候，

　它其实是在服务器上面执行等，因为 window / localstorage 是浏览器的属性对象。

　所以在服务器端跑的时候，就会出现没有定义的错误。

2、解决方案

　　个人觉得可以把这些浏览器的属性重新封装以便使用。

　　例如：

   let targetWin = null
    if(window) targetWin = window
    var proxyWindow = new Proxy(targetWin,{
        get: function (target, key, receiver) {
            if(!targetWin) {
                return Reflect.get({nothing:function () {}}, 'nothing', receiver);
            }
            return Reflect.get(target, key, receiver);
        }
    });

    export default proxyWindow

　　没有在项目中试过，不过我觉得这是一个完美解决方案。

　　上面是用了 es6 的 proxy 做代理。

　　当 window 不存在时候，如果调用了 window 上面的方法或者属性就会执行 nothing 这个方法。

　　也就是说在服务器渲染的时候不会找不到 window ，而会执行 nothing 方法。

　　这样就不会报错了。

　　这里的话，以后使用 window 的对象的话，就需要引用这个模块。

　　以此类推，localstorage / location 等都可以用此类方法实现了。