Firebase Next.js Hosting部署报错：无法找到esbuild

以下是针对该问题的实用排查与解决步骤：

• 清理依赖缓存并统一重新安装
  由于你混用了npm和yarn，可能导致依赖冲突或关联异常。先删除node_modules和锁文件，再用yarn重新安装：

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

• 更新Firebase CLI到最新版本
  旧版CLI可能对Next.js托管的esbuild处理存在兼容问题，执行全局更新：

  yarn global add firebase-tools
  

• 手动指定esbuild路径
  若CLI仍无法定位esbuild，可通过环境变量指定本地安装的二进制文件路径：
  macOS/Linux：

  export ESBUILD_BINARY_PATH="./node_modules/esbuild/bin/esbuild"
  firebase deploy --only hosting,functions -m "testing out next.js support"
  

  Windows：

  set ESBUILD_BINARY_PATH="./node_modules/esbuild/bin/esbuild"
  firebase deploy --only hosting,functions -m "testing out next.js support"
  

• 检查functions子目录的依赖
  如果项目包含单独的functions文件夹，需确保esbuild也安装在该目录的开发依赖中：

  cd functions
  yarn add --dev esbuild
  

  Firebase部署functions时会单独处理该目录的依赖，缺失可能触发报错。

• 通过yarn调用Firebase CLI
  直接用yarn执行部署命令，可能解决依赖查找路径问题：

  yarn firebase deploy --only hosting,functions -m "testing out next.js support"
  

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