Vercel: Build failed
Vercelでのビルドが失敗した場合の原因調査と解決策
概要
Vercelへのデプロイ時にビルドが失敗するエラーです。
エラーメッセージ
``` Error: Build failed Command “npm run build” exited with 1 ```
原因
- 依存関係の問題: パッケージのインストール失敗
- TypeScriptエラー: 型エラーが残っている
- 環境変数の欠落: 必要な変数が未設定
- メモリ不足: ビルドプロセスがOOM
解決策
1. ローカルでビルドを確認
```bash
本番ビルドをローカルで実行
npm run build
または
npx vercel build ```
2. 環境変数を設定
```bash
Vercel CLI で確認
vercel env ls
環境変数を追加
vercel env add NEXT_PUBLIC_API_URL ```
3. Node.jsバージョンを指定
```json // package.json { “engines”: { “node”: “18.x” } } ```
4. ビルドコマンドをカスタマイズ
```json // vercel.json { “buildCommand”: “npm run build”, “installCommand”: “npm ci”, “framework”: “nextjs” } ```
5. TypeScriptエラーを無視(一時対応)
```javascript // next.config.js module.exports = { typescript: { ignoreBuildErrors: true, // 非推奨だが緊急時に }, eslint: { ignoreDuringBuilds: true, }, }; ```
6. メモリを増加
```json // package.json { “scripts”: { “build”: “NODE_OPTIONS=’–max-old-space-size=4096’ next build” } } ```
よくある間違い
- .env.local をコミットしていない(.env.exampleを用意)
- Vercelの環境変数にNEXT_PUBLIC_プレフィックスを忘れる
- monorepoのルートディレクトリ設定ミス
関連エラー
関連エラー
CI/CD の他のエラー
この記事は役に立ちましたか?