运行React SSR开发服务器时ts-loader报times不可迭代错误如何解决?
错误原因
- 核心是
ts-loader@9.x版本在Webpack导出多配置数组(当前项目webpack.config.js同时导出客户端、服务端两份打包配置)场景下的已知兼容问题:多个ts-loader实例共享上下文时,watch模式下的times变量未被正确初始化,导致迭代报错。 - 启动命令配置错误:项目中已经自定义了dev.js来处理编译+监听+启动nodemon运行服务端代码,但package.json的dev脚本配置为
webpack serve,webpack serve是为纯前端项目设计的开发服务器,和SSR启动逻辑冲突,同时触发了双watch逻辑,放大了ts-loader的兼容bug。
修复方案
按以下步骤操作即可解决:
步骤1:修改启动命令
把package.json里的scripts.dev改成直接运行自定义的dev.js:
"scripts": { "build": "webpack", "dev": "node ./configs/dev.js" }
步骤2:修复ts-loader配置兼容性
两种方案任选其一即可:
方案A:降级ts-loader到兼容版本
npm install ts-loader@8.3.0 --save-dev
方案B:给两份webpack配置的ts-loader添加独立实例标识
分别修改webpack.client.config.js和webpack.server.config.js里的ts-loader规则,添加options.instanceName配置:
- 客户端配置修改:
// webpack.client.config.js module: { rules: [{ test: /\.[jt]sx?$/, loader: 'ts-loader', exclude: /node_modules/, options: { instanceName: 'client' } }] }
- 服务端配置修改:
// webpack.server.config.js module: { rules: [{ test: /\.[jt]sx?$/, loader: 'ts-loader', exclude: /node_modules/, options: { instanceName: 'server' } }] }
步骤3:可选依赖兼容升级(推荐)
当前使用的webpack-dev-server@3.x和webpack 5兼容性不佳,若后续有需要用到devServer的场景,可以升级到v4版本:
npm install webpack-dev-server@latest --save-dev
修改完后重新执行npm run dev即可正常启动开发服务。
内容的提问来源于stack exchange,提问作者Paul
相关产品推荐
相关产品推荐

