Next.js运行正常,生产构建报Cannot read property 'pop' of undefined错误求助
问题根因定位
- 从终端日志的报错位置可以明确,崩溃发生在生产构建生成静态CSS文件的环节,错误
Cannot read property 'pop' of undefined本质是2020年12月发布的Next.js 10.0 初始版本存在CSS处理管线的代码bug,内置的依赖映射与postcss、cssnano的实际运行状态不匹配。 - 开发模式下运行无异常的原因:
npm run dev启动时,Next.js不会对CSS执行生产级的压缩、规则合并逻辑,会跳过触发bug的代码分支,因此问题不会暴露;只有执行npm run build触发生产构建,走到CSS压缩处理的分支时才会触发崩溃。 - 日志中打印的postcss弃用警告是独立的Node.js兼容性提示,和本次编译失败没有因果关系,无需优先处理。
可落地解决步骤
- 核心修复操作:升级Next.js到bug修复版本
在项目根目录执行命令,将Next.js升级到10.0.5及以上版本,该版本官方已修复CSS管线读取未定义变量的问题:npm install next@10.0.5 react react-dom - 临时规避方案(无法立即升级Next.js版本时使用)
在项目根目录的next.config.js中添加配置,绕开触发bug的CSS处理逻辑:module.exports = { webpack: (config, { dev }) => { // 生产构建下关闭CSS模块顺序校验,避免管线内部数组状态异常 if (!dev) { const cssExtractPlugin = config.plugins.find( item => item.constructor.name === 'MiniCssExtractPlugin' ) if (cssExtractPlugin) { cssExtractPlugin.options.ignoreOrder = true } } return config } } - 清缓存验证步骤
完成配置调整后,清理本地残留的编译缓存和旧依赖,避免旧文件导致报错复现:- 删除项目根目录下的
.next构建缓存文件夹 - 删除
node_modules文件夹和package-lock.json文件 - 重新执行
npm install安装全量依赖 - 再次运行
npm run build验证构建是否正常通过
- 删除项目根目录下的
内容的提问来源于stack exchange,提问作者Murtuja Kavantwala
相关产品推荐
相关产品推荐

