Vercel で monorepo のルートディレクトリが検出されずビルドが失敗する
Vercel で monorepo のビルドが落ちるなら、Root Directory にアプリのパスを設定すれば直る。
No Next.js version detected などは monorepo のトップで実行されたときに出る。
公開: 更新:
要約
Vercel は monorepo を自動検出しようとするが、Turborepo / pnpm workspace / Nx の組み合わせや非標準ディレクトリでは Root Directory を手動指定しないと正しく動かない。
Project Settings の Root Directory、Build Command、Install Command の 3 つを揃えるのが基本である。
詳細は 公式 monorepo ドキュメント(新しいタブで開く) にまとまっている。
解決策
1. Root Directory を設定する
Vercel ダッシュボード → Project Settings → General → Root Directory に apps/web などデプロイ対象のパスを入れる。
これだけで Next.js / Remix 等は通常正しく検出される。
2. ワークスペース対応の Build Command
Turborepo を使うなら、ルートから filter 指定でビルドする。
cd ../.. && pnpm turbo run build --filter=webTurborepo on Vercel ドキュメント(新しいタブで開く) では、turbo 1.8 以降なら Root Directory からフィルタが自動で推定されるため Build Command は turbo build だけでよいとされ、cd ../.. && turbo run build --filter=web の形も併記されている。
3. Install Command を明示する
pnpm install --frozen-lockfileVercel は lockfile からパッケージマネージャを推測するが、複数 lockfile が混在すると失敗する。
Project Settings → Build & Development Settings で明示する。
4. vercel.json で固める
{
"buildCommand": "cd ../.. && pnpm turbo run build --filter=web",
"installCommand": "pnpm install --frozen-lockfile",
"outputDirectory": ".next"
}設定できる項目は Project Configuration リファレンス(新しいタブで開く) に載っている。
よくある原因
- Root Directory を設定していない。
monorepo のトップのまま検出に任せると、Next.js / Remix 等のバージョン検出で失敗する。 - Build Command がワークスペースに対応していない。
npm run buildが対象アプリのスクリプトを呼べない。 - Install Command が一致していない。
pnpm を使っているのにnpm installのままになっていて、lockfile / node_modules が壊れる。 - Output Directory を取り違えている。
ルートで build した想定の.nextを、Vercel が探しに行く。