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就是帮我们在服务触发了SSR和SSP时,主动触发一个约定的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的版本依赖,并且通过原本项目中所有的测试用例。目前在我的项目中运行一切正常,并没有发现任何异常,大家可以放心使用。

相关推荐
kyriewen10 分钟前
编辑弹窗点了取消,列表里的数据怎么还是变了?
前端·javascript·人工智能
Karl_fang24 分钟前
🥳 再也不用拿起手机抄验证码!我做了一个 Android → Mac 的「验证码接力」工具
前端·macos·ai编程
逛逛GitHub43 分钟前
Claude 最新模型发布 1 周了,瞧瞧外网惊艳到震撼的玩法。
github
逛逛GitHub1 小时前
最近逛 GitHub 挑了 8 个刚开源、Star 涨得挺快的项目。
github
谭光志2 小时前
如何让 AI 高效工作
前端·后端·ai编程
code2cat2 小时前
【随笔】MCP长任务:查询已经返回,为什么任务还没有完成
javascript·人工智能·后端·mcp
FRing032 小时前
vue2干货总结11(短信验证、登录功能、统一处理错误(响应拦截器)、将token信息存入vuex、vuex持久化处理)
开发语言·前端·javascript·vue.js·vue2
泯泷2 小时前
改一个字,整段都红了?——中文内容差异对比的算法与协议设计
前端·javascript·typescript
再吃一根胡萝卜3 小时前
DSH plugin 开发示例:五种插件形态完整代码整理
前端
dong_junshuai3 小时前
每天一个开源项目#158 AG-UI:让Agent事件流接上前端状态
github