できない.dev

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=web

Turborepo on Vercel ドキュメント(新しいタブで開く) では、turbo 1.8 以降なら Root Directory からフィルタが自動で推定されるため Build Command は turbo build だけでよいとされ、cd ../.. && turbo run build --filter=web の形も併記されている。

3. Install Command を明示する

pnpm install --frozen-lockfile

Vercel は 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 リファレンス(新しいタブで開く) に載っている。

よくある原因

  1. Root Directory を設定していない。
    monorepo のトップのまま検出に任せると、Next.js / Remix 等のバージョン検出で失敗する。
  2. Build Command がワークスペースに対応していない。
    npm run build が対象アプリのスクリプトを呼べない。
  3. Install Command が一致していない。
    pnpm を使っているのに npm install のままになっていて、lockfile / node_modules が壊れる。
  4. Output Directory を取り違えている。
    ルートで build した想定の .next を、Vercel が探しに行く。