Next.js构建时报Cannot read property 'b' of undefined错误求助

报错可能原因 #

• 生产构建压缩混淆导致的变量名缩写：生产构建时Next.js默认会开启代码压缩，会把对象属性、内部变量压缩为单字母名称，你看到的属性b是压缩后的名称，对应你代码或者第三方依赖里的某个正常命名属性，只有生产环境压缩逻辑会触发这个转换，所以开发模式、设置NODE_ENV为development构建时都不会复现。
• 子组件公共依赖的生产兼容问题：所有子组件共同依赖的公共Hooks、工具函数、第三方组件存在生产环境兼容性问题，单独注释单个子组件时公共依赖仍然被引用，只有注释所有子组件后公共依赖不会被加载，报错才会消失。
• 静态生成序列化逻辑异常：Next.js生产构建时会对getStaticProps返回的参数、组件传递的属性做序列化校验，如果你代码里存在不可序列化的值（函数、Symbol、类实例等），开发模式不会做强校验，生产构建时序列化逻辑抛出的异常会被压缩为访问属性b的报错。
• 生产环境专属编译插件异常：你项目中可能配置了仅在生产环境启用的SWC/Babel编译插件、代码优化规则，这些规则转换后的代码存在逻辑错误，仅在生产构建时触发。

排查解决方法 #

• 先关闭压缩定位报错源：修改next.config.js配置，关闭代码压缩和变量混淆：

  /** @type {import('next').NextConfig} */
  const nextConfig = {
    swcMinify: false, // 如果你用SWC压缩
    productionBrowserSourceMaps: true, // 开启生产环境sourcemap
  }
  module.exports = nextConfig
  

  重新执行生产构建，此时报错会展示原始的属性名称和报错位置，直接定位到具体出错的代码逻辑。
• 排查公共依赖逻辑：提取所有子组件共同引入的公共逻辑，逐个做mock替换测试构建，找到触发报错的具体公共依赖项。
• 校验序列化合法性：检查所有组件传递的属性、getStaticProps返回的所有字段，确保没有不可序列化的类型值。
• 排查编译配置：关闭所有仅在生产环境启用的编译插件、优化规则，逐个开启测试构建，定位到出错的配置项。
• 升级依赖版本：将Next.js、React、React-dom以及你用到的UI组件库升级到最新稳定版，这类压缩导致的无明确指向报错大部分是已知的依赖bug，升级后可直接解决。

内容的提问来源于stack exchange，提问作者Sid