Nextjs14使用next-redux-wrapper报错解法

前言

随着Nextjs V14版本的发布,应该越来越多小伙伴开始会使用Nextjs V14进行开发,或者之前使用较旧版本的项目也会存在升级的需求。那么如果你和我一样使用的是Nextjs V13.5之前的版本进行升级,并且你的Nextjs项目使用了next-redux-wrapper,那么恭喜你,很有可能会踩坑了。

什么是next-redux-wrapper?

next-redux-wrapper是一个第三方库,主要作用是在我们使用Nextjs进行项目开发时,依赖Redux进行数据管理,那么服务端客户端的Store是不同步的。一般情况下,我们是需要自己手动去处理的。而 next-redux-wrapper就是帮我们在服务触发了SSRSSP时,主动触发一个约定的Action来触发 Reducers实现服务端客户端的Store同步的。

next-redux-wrapper​github.com/kirill-konshin/next-redux-wrapper

遇到什么坑?

当你开开心心的升级了Nextjs到V14版本,同时使用了next-redux-wrapper,并且成功编译,兴致勃勃的打开localhost:3000准备查看一番的时候, 你很有可能会看到如下报错:

ruby 复制代码
 ⨯ Error: NextRouter was not mounted. https://nextjs.org/docs/messages/next-router-not-mounted
    at useRouter (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/next-redux-wrapper/node_modules/next/dist/client/router.js:146:15)
    at useHybridHydrate (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/next-redux-wrapper/lib/index.js:250:45)
    at Object.useWrappedStore (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/next-redux-wrapper/lib/index.js:298:9)
    at MyApp (webpack-internal:///./pages/_app.tsx:59:80)
    at renderWithHooks (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/react-dom/cjs/react-dom-server.browser.development.js:5658:16)
    at renderIndeterminateComponent (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/react-dom/cjs/react-dom-server.browser.development.js:5731:15)
    at renderElement (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/react-dom/cjs/react-dom-server.browser.development.js:5946:7)
    at renderNodeDestructiveImpl (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/react-dom/cjs/react-dom-server.browser.development.js:6104:11)
    at renderNodeDestructive (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/react-dom/cjs/react-dom-server.browser.development.js:6076:14)
    at renderContextProvider (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/react-dom/cjs/react-dom-server.browser.development.js:5920:3)
    at renderElement (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/react-dom/cjs/react-dom-server.browser.development.js:6017:11)
    at renderNodeDestructiveImpl (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/react-dom/cjs/react-dom-server.browser.development.js:6104:11)
    at renderNodeDestructive (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/react-dom/cjs/react-dom-server.browser.development.js:6076:14)
    at renderIndeterminateComponent (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/react-dom/cjs/react-dom-server.browser.development.js:5785:7)
    at renderElement (/Users/lamho/Desktop/tencent/monorepo/frontend/node_modules/react-dom/cjs/react-dom-server.browser.development.js:5946:7) {
  page: '/'
}

瞬间一脸懵逼有没有!!!

问题是什么?

通过next-redux-wrapper的描述,说明是支持9.5以上的版本的。

难道作者骗我吗?看了一下最后更新版本的记录,最新一个版本已经是接近1年前了。心都凉了。

反手想给作者提个issue说明一下问题,结果发现一个老哥已经遇到的问题#564 ,很遗憾的是,作者也没有理我们,那我只好排查一下看看到底是哪里有问题了。

通过错误信息可以看出,这里意思应该没有找到NextRouter的Provider,next-router-not-mounted

经过排查代码断点最定定位到了问题所在,首先NextRouter没有挂载错误的原因是next-redux-wrapper使用了next的v12版本作为依赖,在代码中的useHybridHydrate函数中,router对象是通过next/router获得的,当路由发生变化时,routeChangeStart事件一定会触发Hydrate。

通过对比next v12和v14的源代码,发现routerContext的文件路径从shared/lib/router-contextbiu变成了shared/lib/router-context.shared-runtime。导致路由器上下文不能正确获取,最终导致程序异常。

确切地说,这个问题应该从v13.5.0开始就存在了

router.ts(v13.4.19 and earlier)

typescript 复制代码
/* global window */
import React from 'react'
import Router from '../shared/lib/router/router'
import type { NextRouter } from '../shared/lib/router/router'
import { RouterContext } from '../shared/lib/router-context'
import isError from '../lib/is-error'

// ...

router.ts(v14.0.2)

typescript 复制代码
/* global window */
import React from 'react'
import Router from '../shared/lib/router/router'
import type { NextRouter } from '../shared/lib/router/router'
import { RouterContext } from '../shared/lib/router-context.shared-runtime'
import isError from '../lib/is-error'

// ...

以下是几个版本的router函数链接

如何解决

本来我尝试通过Fork代码进行修改,然后提交给作者,但是我一直无法正常的安装所需依赖,无奈之下我新建了一个仓库,对源代码进行修改,并重新提交一个新的NPM包。

next-redux-wrapper-future​github.com/LLLLLamHo/next-redux-wrapper-future#next-redux-wrapper-future

大家可以通过npm install next-redux-wrapper-future或使用yarn进行安装。

我全面升级了包中对react和next的版本依赖,并且通过原本项目中所有的测试用例。目前在我的项目中运行一切正常,并没有发现任何异常,大家可以放心使用。

相关推荐
憧憬成为web高手5 小时前
ACTF 12307复现
前端·bootstrap·html
wordbaby5 小时前
Axios 上传大文件崩溃:鸿蒙 RNOH 下 XHR 返回空响应头引发的"假失败"
前端·react native
wordbaby6 小时前
React Native 列表分页实战:下拉刷新与上拉加载的工程化方案
前端·react native
星栈独行6 小时前
我在 Rust 全栈项目里用 JWT 做无状态认证
开发语言·后端·rust·前端框架·开源·github·web
2601_955781986 小时前
飞书远程控机:OpenClaw配置全攻略
人工智能·开源·github·飞书·open claw安装·open claw部署
wordbaby6 小时前
脱离 Tab 栏的艺术:React Native 全屏子页面的导航架构实践
前端·react native·harmonyos
陈随易7 小时前
Redis 8.8发布,一定要更新
前端·后端·程序员
wordbaby7 小时前
React Native 新架构落地鸿蒙:跨三端政务级应用的工程实践与深度复盘
前端·react native·harmonyos
晓说前端7 小时前
第一篇:为什么学TypeScript?—— 优势、场景与环境搭建
javascript·ubuntu·typescript
excel8 小时前
为什么我推荐使用 Termius:现代 SSH 工具的完整体验
前端·后端