Vercel

エラーの概要 Vercel の 400 エラーは、Vercel API へ送信されたリクエストの形式または内容に不正がある場合に発生します。これはクライアント側の誤りを示す HTTP ステータスコードで、デプロイ時や API 呼び出し時に頻繁に遭遇します。Vercel CLI を使用したデプロイ、または直接 API を呼び出している場合に特に注意が必要です。 実際のエラーメッセージ例 { "error": { "code": "BAD_REQUEST", "message": "Invalid request body" } } Error: Bad Request (400) POST /v13/deployments よくある原因と解決手順 原因1：vercel.json の設定に誤りがある vercel.json は、Vercel のデプロイ設定を定義する重要なファイルです。JSON の形式エラーや、キーの綴り間違い、不正な値の型が 400 エラーを引き起こします。例えば、環境変数の設定項目のキー名を間違えたり、配列であるべき値をオブジェクトとして定義したりすると、API リクエストが拒否されます。 Before（エラーが起きるコード）： { "buildCommand": "npm run build", "installCommand": "npm install", "outputDirectory": "dist", "env": { "DATABASE_URL": "postgresql://..." }, "enviroments": { "production": { "DATABASE_URL": "postgresql://prod..." } } } After（修正後）： { "buildCommand": "npm run build", "installCommand": "npm install", "outputDirectory": "dist", "env": { "DATABASE_URL": "postgresql://..." }, "envs": [ { "key": "production", "value": { "DATABASE_URL": "postgresql://prod..." } } ] } 原因2：API リクエストの必須パラメーターが欠けている Vercel API を直接呼び出す場合、認証トークンやプロジェクト ID、デプロイ対象のファイル情報など、必須パラメーターの不足が 400 エラーを引き起こします。特にカスタムスクリプトや CI/CD パイプライン（継続的インテグレーション・デプロイメント）から自動デプロイする場合、リクエストボディの構造を厳密に確認する必要があります。 ...

Vercel 401 エラーの原因と解決方法 エラーの概要 Vercel 401 エラーは、Vercel のサーバーに対して実施した認証に失敗したことを示します。API トークンの無効化、環境変数の設定漏れ、外部サービス連携の切断など、認証周辺の問題が原因となり、デプロイや CLI 操作が停止します。このエラーが発生するとプロジェクトのデプロイメントパイプラインが完全に止まるため、素早い対応が必要です。 実際のエラーメッセージ例 Vercel CLI からの出力： Error: Authentication failed (401 Unauthorized) The provided token is invalid or has expired. GitHub Actions 内でのレスポンス： { "error": { "code": "AUTHENTICATION_FAILED", "message": "Authentication token is invalid or expired (401)", "status": 401 } } curl 経由でのレスポンス： curl -H "Authorization: Bearer <invalid_token>" https://api.vercel.com/v1/projects HTTP/1.1 401 Unauthorized { "error": { "code": "unauthorized", "message": "Invalid token" } } よくある原因と解決手順 原因1：Vercel API トークンが無効または期限切れになっている Vercel ダッシュボードで生成した API トークンは、セキュリティ上の理由から一定期間の有効期限が設定されることがあります。また、トークンを削除した後も環境変数に古い値が残っていると、認証に失敗します。 ...

エラーの概要 Vercel の 403 エラーは、デプロイや API 呼び出し時にプロジェクトやリソースへのアクセス権限がないことを意味します。これは認証自体は成功しているものの、認可レベルで拒否される状態です。Vercel では、個人アカウント・チームアカウント・API トークンのスコープによって権限が厳密に管理されており、不適切な組み合わせで 403 エラーが発生することが頻繁にあります。 実際のエラーメッセージ例 Vercel CLI デプロイ時： Error: Received 403 from https://api.vercel.com/v13/deployments You do not have permission to access this resource API レスポンス： { "error": { "code": "FORBIDDEN", "message": "You do not have permission to access this project", "status": 403 } } よくある原因と解決手順 原因1：別のチームのプロジェクトに個人トークンでアクセスしている 個人アカウントの API トークンを使用しながら、チームが所有するプロジェクトにアクセスしようとすると 403 エラーが発生します。Vercel では個人スコープのトークンではチーム配下のリソースにアクセスできません。 修正前： # 個人アカウントのトークンでチームプロジェクトにデプロイ export VERCEL_TOKEN=<個人スコープのトークン> export VERCEL_ORG_ID=team_xxx # チームID export VERCEL_PROJECT_ID=<プロジェクトID> vercel deploy 修正後： # チームスコープを持つAPIトークンを使用 export VERCEL_TOKEN=<チームスコープのトークン> export VERCEL_ORG_ID=team_xxx export VERCEL_PROJECT_ID=<プロジェクトID> vercel deploy チームスコープのトークンを生成するには、Vercel Dashboard で Settings → Tokens → Create → Scope を「Team」に設定します。 ...