You need to enable JavaScript to run this app. 升级到Next.js 11后出现Cannot read property 'forEach' of undefined报错如何解决
优惠活动
大模型
产品
解决方案
定价
更多

升级到Next.js 11后出现Cannot read property 'forEach' of undefined报错如何解决

问题产生原因

  • 硬编码webpack规则索引失效:Next.js 11重构了内部webpack规则的排列结构,旧代码中直接取config.module.rules[1]的硬编码写法无法匹配到正确的css规则组,要么读取到undefined抛出遍历错误,要么修改的根本不是目标loader配置,是你第一段代码报错的核心原因。
  • 规则执行顺序导致的问题暴露:你删除css修改代码后才遇到svg报错,是因为原来的css代码报错直接阻断了webpack配置的执行流程,冲突问题没有暴露出来。
  • SVG规则冲突:Next.js 11新增了内置的SVG静态资源处理逻辑,你原有直接push@svgr/webpack规则的写法会和内置规则冲突,是svg相关报错的根本原因。

修复方案

方案一:全量兼容修改(保留原有自定义逻辑)

直接调整next.config.js中的webpack配置,替换硬编码索引写法、排除内置svg规则即可:

module.exports = {
  // 你原有其他配置项
  webpack: (config, { buildId, dev, isServer, defaultLoaders, webpack }) => {
    // 1. 替换原有硬编码索引的css-loader修改逻辑
    config.module.rules.forEach(rule => {
      if (!Array.isArray(rule.oneOf)) return
      rule.oneOf.forEach(moduleLoader => {
        if (!Array.isArray(moduleLoader.use)) return
        moduleLoader.use.forEach(l => {
          if (
            l.loader?.includes("css-loader") && 
            l.options?.modules && 
            l.options.modules.exportLocalsConvention
          ) {
            l.options = {
              ...l.options,
              modules: {
                ...l.options.modules,
                exportLocalsConvention: "camelCase",
              }
            }
          }
        })
      })
    })

    // 2. 排除Next.js内置svg规则,避免冲突
    config.module.rules.forEach(rule => {
      if (rule.test.toString().includes('svg')) {
        rule.exclude = /\.svg$/
      }
    })

    // 3. 添加你原有自定义svg规则
    config.module.rules.push({
      test: /\.svg$/,
      use: [{
        loader: '@svgr/webpack',
        options: {
          svgoConfig: {
            plugins: [{ cleanupIDs: false }]
          }
        }
      }],
    })

    // 必须返回修改后的config
    return config
  }
}

方案二:使用内置配置简化(更稳定推荐)

如果你仅需要修改css modules的导出命名规则,无需手动修改webpack loader配置,直接使用Next.js 11内置的配置项即可,代码更简洁、不会随版本迭代失效:

module.exports = {
  // 你原有其他配置项
  cssModules: {
    exportLocalsConvention: "camelCase",
  },
  webpack: (config, { buildId, dev, isServer, defaultLoaders, webpack }) => {
    // 排除Next.js内置svg规则
    config.module.rules.forEach(rule => {
      if (rule.test.toString().includes('svg')) {
        rule.exclude = /\.svg$/
      }
    })

    // 添加自定义svg规则
    config.module.rules.push({
      test: /\.svg$/,
      use: [{
        loader: '@svgr/webpack',
        options: {
          svgoConfig: {
            plugins: [{ cleanupIDs: false }]
          }
        }
      }],
    })

    return config
  }
}

内容的提问来源于stack exchange,提问作者RandomDeveloper

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.15 18:36:07