启动Blitzjs应用时加载next.config.js失败的问题求助

问题场景 #

执行 blitz dev 命令启动 Blitz.js 应用时失败，抛出以下错误：

error Failed to load next.config.js
Error: Cannot find module 'next/dist/client/resolve-href'

解决步骤 #

• 核对依赖版本兼容性：Blitz.js 与 Next.js 版本不匹配是核心诱因。打开项目的 package.json，查看 blitz 和 next 的版本号，确保二者版本适配（可参考 Blitz.js 官方推荐的版本组合）。

• 重装依赖：

  1. 删除本地依赖文件夹：rm -rf node_modules（Windows 环境执行 rmdir /s/q node_modules）
  2. 删除包管理锁文件：rm package-lock.json 或 rm yarn.lock（根据使用的包管理器选择）
  3. 重新安装依赖：npm install 或 yarn install

• 检查 next.config.js 配置：若项目自定义了 next.config.js，确认文件中是否存在引用 next/dist/client/resolve-href 的代码，或配置格式是否有误。如果是 Blitz.js 默认生成的配置，可先恢复默认配置再尝试启动。

• 清理缓存：

  1. 清理 Next.js 缓存：npx next clean
  2. 清理包管理器缓存：npm cache clean --force 或 yarn cache clean

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