クラウド
Vercel
Next.js を中心に React / Svelte / Astro などのフロントエンドアプリを Edge / Serverless 環境にデプロイするクラウドプラットフォーム。Git 連携プレビューデプロイ、環境変数管理、Edge / Node ランタイム、Image / Function の最適化を提供する。
問題一覧（8）
Vercel でビルドが失敗してデプロイできない
Vercel のビルド失敗はローカルでは出ない原因に集中する。Vercel と手元の Node バージョン差、Project Settings の Build Command / Output ズレ、build-time 環境変数不足、lockfile 不整合、monorepo Root Directory 誤りの 5 系統を順に切り分ける。
更新: 2026-05-27、タグ: build、deploy、nextjs
Vercel Cron Jobs が実行されない
vercel.json がプロジェクトルートに無い、path が存在しないルートを指している、Hobby プランの 1 日 1 回上限に当たっている、Production にデプロイしていない、の 4 系統が大半。Project → Cron Jobs タブで実行履歴を確認する。
更新: 2026-07-30、タグ: cron、schedule、deploy
Vercel のカスタムドメインが反映されない
Vercel にドメインを追加してもアクセスできない事象は DNS の A / CNAME 値、伝播待ち、SSL 証明書発行、Production ブランチ未デプロイのいずれかが原因。Domains 画面の Configuration 指示通りに DNS を登録するのが起点。
更新: 2026-07-04、タグ: domain、dns、ssl
Vercel が git push してもデプロイされない
Vercel のデプロイが push で起動しないのは、Git Integration の切断、Production Branch 未一致、Ignored Build Step での skip、monorepo Root Directory 外の変更が主因。Project Settings → Git で接続と Production Branch を、Deployments タブで Skipped 表示を確認する。
更新: 2026-06-01、タグ: deploy、git、monorepo
Vercel Edge Runtime で Node.js API（fs / child_process 等）が使えない
Edge Runtime は V8 isolate 上で動く Web 標準 API のみのサンドボックスで Node.js ではない。fs / child_process / net / ネイティブモジュールは使えない。Node API が必要なら runtime を nodejs に切り替える。
更新: 2026-07-01、タグ: edge-runtime、nodejs、runtime
Vercel で環境変数が反映されない
Vercel の環境変数は Production / Preview / Development の 3 環境で別管理される。環境チェック漏れ、NEXT_PUBLIC_ 接頭辞不足、変更後の再デプロイ忘れ、build-time / runtime の混同が反映されない典型原因。
更新: 2026-05-27、タグ: environment、deploy、runtime
Vercel の Serverless Function がタイムアウトする
Vercel Function は実行時間に上限がある。既定は全プラン 300 秒で、Hobby は 300 秒が上限、Pro / Enterprise は maxDuration で 800 秒まで延ばせる。maxDuration 設定、Promise.all での並列化、ジョブキューへの退避、ストリーミングで切断回避の 4 系統で解決する。
更新: 2026-07-30、タグ: serverless、timeout、runtime
Vercel で monorepo のルートディレクトリが検出されずビルドが失敗する
Turborepo / pnpm workspace / Nx などの monorepo を Vercel にデプロイすると、プロジェクトルートではなく monorepo のトップで実行され No Next.js version detected 等で落ちる。Root Directory・Build Command・Install Command の 3 つを正しく組む。
更新: 2026-08-03、タグ: monorepo、build、turborepo