运行React程序时遇Error: Cannot find module 'next/dist/compiled/semver'问题求助

这个错误通常由Next.js依赖缺失、版本冲突或缓存异常导致，以下是可落地的修复方案：

基础依赖重置 #

• 删除本地依赖文件夹与锁文件：

  rm -rf node_modules package-lock.json yarn.lock
  

  Windows系统对应命令：

  rmdir /s /q node_modules
  del package-lock.json yarn.lock
  

• 清除npm缓存并重新安装依赖：

  npm cache clean --force
  npm install
  

版本兼容调整 #

• 更新或锁定Next.js至稳定版本：

  # 更新到最新稳定版
  npm install next@latest
  # 或锁定到已知兼容版本（如13.4.12）
  npm install next@13.4.12
  

• 检查package.json中Next.js的版本范围，避免使用^或~这类可能引发版本波动的符号，直接指定具体版本号。

依赖冲突排查 #

• 查看semver依赖树，确认是否存在第三方包导致的版本冲突：

  npm ls semver
  

• 若发现冲突，在package.json中添加版本强制覆盖：

  "overrides": {
    "semver": "7.5.4"
  }
  

  添加完成后重新执行npm install。

清除Next.js缓存 #

• 删除Next.js生成的缓存文件夹：

  rm -rf .next
  

• 重启开发服务：

  npm run dev
  

错误截图 #

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