MeWrite Docs

Vercel: Build failed

Vercelでのビルドが失敗した場合の原因調査と解決策

概要

Vercelへのデプロイ時にビルドが失敗するエラーです。

エラーメッセージ

``` Error: Build failed Command “npm run build” exited with 1 ```

原因

  1. 依存関係の問題: パッケージのインストール失敗
  2. TypeScriptエラー: 型エラーが残っている
  3. 環境変数の欠落: 必要な変数が未設定
  4. メモリ不足: ビルドプロセスが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 の他のエラー

最終更新: 2025-12-11