Next.js执行next export出现Registry重复声明错误求助

• 定位重复声明的代码

  • 全局搜索项目中所有含Registry的代码，检查是否存在同一作用域内重复声明（比如同一文件两次const Registry = ...），或全局环境下重复挂载的情况
  • 重点排查_app.js/_app.tsx文件，错误出现在_app-xxx.js中，大概率是该文件代码或其引入的依赖存在问题
  • 检查第三方库是否重复引入Registry变量，比如Emotion、Styled Components这类带Registry机制的UI库，是否在静态导出流程中被重复加载

• 回溯代码变更

  • 用Git二分查找快速定位问题提交：执行git bisect start，标记已知正常的提交git bisect good <正常提交哈希>，标记当前坏提交git bisect bad，按提示逐步测试，缩小问题范围
  • 重点关注近期修改的依赖、_app相关文件、自定义_document.js/_document.tsx文件，这些是影响静态导出的高频修改点

• 检查Next.js静态导出配置

  • 确认next.config.js中是否配置了output: 'export'（Next.js 12+需显式配置才能正常导出静态文件）
  • 排查是否使用了不兼容静态导出的API，比如getServerSideProps、getInitialProps，这类API在静态导出时可能引发打包异常，建议替换为getStaticProps/getStaticPaths
  • 清理缓存后重新构建：删除.next、out目录，重新安装依赖，再执行next build && next export

• 调试静态导出代码

  • 构建后打开out/_app-fe2f21502718f029.js，定位第183行附近的代码，直接查看Registry重复声明的具体场景，锁定问题根源
  • 在开发模式下运行next dev，看是否能复现相同错误：如果开发模式正常，说明问题出在静态导出的打包逻辑上

• 排查依赖版本

  • 检查与Registry相关的依赖（如@emotion/react、styled-components）是否有版本更新，尝试回退到之前的稳定版本测试
  • 锁定Next.js版本为12.3.4（去掉版本号前的^），避免小版本自动升级带来的兼容性问题

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