You need to enable JavaScript to run this app. Next.js运行正常,生产构建报Cannot read property 'pop' of undefined错误求助
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.12 10:45:02