升级到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
相关产品推荐
相关产品推荐

