Vercel Cronの料金体系や無料枠の制限はどうなっていますか？

Hobbyプランは無料でCronを利用可能です。ただし、実行できるジョブは1つまでで、頻度は1日に1回という制限があります。

Vercel cron job not working（動かない）場合の対処法は？

vercel.jsonの記述ミスやエンドポイントのパスを確認してください。また、Cronシークレットのバリデーションに失敗しているケースも多いです。

セキュリティのためにVercel cron secretはどう使いますか？

環境変数のCRON_SECRETと比較して認証を行います。リクエストヘッダーのAuthorizationと値を照合し、不正アクセスを防ぎましょう。

VercelのCron設定手順・無料枠の条件と安全な実装【完全版】

モダンWeb開発2026.04.172026.04.17

執筆者編集部

MT Templates 編集部

監修者MT Templates 代表/編集長

大野浩史

この記事のポイント

Vercel Cronは、Next.jsのAPIルートとvercel.jsonの設定によりインフラ構築なしで定期処理を実装でき、無料枠では1時間間隔で利用可能であり、CRON_SECRETの検証によって不正アクセスを防ぐ安全な自動化を実現します。

Vercelでcronジョブを実装する具体的な手順を知り、外部サービスを使わずインフラ管理の手間やコストを最小限に抑えたいと考えていませんか。Next.jsを利用したプロジェクトなら、標準機能で定期実行タスクを簡単に構築可能です。

こうした疑問に答えます。

本記事の内容

Vercel Cronの基本仕様と料金体系や無料枠の制限
Next.jsでのAPI実装とvercel.jsonの設定手順
CRON_SECRETを活用した不正アクセスを防ぐセキュリティ対策

Vercel Cronを使えば、vercel.jsonとAPIルートの設定だけで手軽にジョブを作成できます。npmのcronパッケージなどを別途導入する必要もありません。

開発中の確認に便利なCron job preview機能や、実行されない場合のトラブルシューティング、タイムゾーンの注意点まで網羅しました。セキュリティを高めるvercel cron_tokenの扱いや、Vercel cron job not workingといった問題への対処法も解説します。安全で効率的な自動化を実現するために、ぜひ最後まで読み進めてください。

Vercel Cronの基本仕様

Vercel Cronは、vercelとはNext.js開発元が提供するプラットフォーム上でアプリケーションに特定のスケジュールで定期処理を実行させる機能です。Vercel上でバッチ処理やデータ更新を完結できるため、インフラ構成をシンプルに保てます。

定期実行の仕組み

Vercel Cron Jobsは、内部的にAmazon EventBridgeスケジューラを利用しています。指定したスケジュールに従い、HTTPリクエスト経由でAPIルートをトリガーして定期処理を行います。

具体的な設定手順は以下の通りです。

プロジェクトのルートにあるvercel.jsonにパスとスケジュールを記述
標準的なcron式を用いて実行タイミングを定義
デプロイ時にVercelが設定を読み込みスケジュールを自動登録

セキュリティ対策として、実行時にはVercel cron secretを含むAuthorizationヘッダーが付与されます。開発者はVercel cron_tokenを検証することで、外部からの不正なアクセスを確実に防げる仕組みです。

料金プラン別の実行制限

Vercel Cron 料金は、契約しているプランによって実行可能な頻度が大きく異なります。分単位の細かい実行が必要な場合は、Proプラン以上の検討が必要です。

プランごとの制限の違いをまとめました。

項目	Vercel Cron 無料 (Hobby)	Proプラン
最小実行間隔	1時間ごと	1分ごと
スケジュールの粒度	1時間単位	1分単位
最大ジョブ数	2件	40件

有料ユーザーはAmazon EventBridgeの能力をフルに活用し、高頻度なジョブ実行を行えます。

無料プランで使うための条件

HobbyプランでもNext.js cronなどの機能を活用できますが、プラットフォームが定める実行間隔を遵守しなければなりません。リソースの適正利用のため、無料ユーザーには頻度の上限が設けられています。

無料枠で利用するための条件は以下の通りです。

cron式の設定で実行間隔を1時間以上に指定すること
1時間を下回る頻度の設定値はエラーになるため避けること
小規模なプロジェクトや個人開発の範囲で利用すること

1時間間隔の制限内であれば、ドキュメントの同期や簡易的な通知処理に十分活用できます。

タイムアウトの注意点

Vercel Cronを実行する際は、Serverless Functionsのタイムアウト制限を考慮する必要があります。処理が完了する前に制限時間を超えると、バッチ処理が途中で強制終了されてしまいます。

運用の際の考慮事項は以下の通りです。

長時間の処理はタスクを細分化して設計する
各プランの最大実行時間を事前に把握して実装する
外部APIの遅延を想定し適切なエラーハンドリングを行う

エッジで実行する場合はVercel Edge Functionsの制約による厳しい時間上限にも注意が必要で、Vercel cron job not workingという事態を避けるため、未処理分を次回に回すなどの工夫が有効です。開発環境ではVercel cron job preview機能を活用し、動作確認を事前に行うことを推奨します。

Vercel Cronの設定手順

Vercel Cronを活用すると、外部サーバーを立てずにVercel内で定期実行タスクを完結できます。インフラ管理コストを抑えつつ効率的な運用を始めるため、まずは基本的な導入の流れを学びましょう。

①：Next.jsでAPIエンドポイントを作成する

Vercel Cronを動かすには、処理の起点となるAPIエンドポイントが必要です。Vercel側から定期的にHTTP GETリクエストが送られ、記述したプログラムがトリガーされます。

VercelとNext.jsの連携を前提としたNext.js cronの実装では、app/api/cron/route.tsなどのパスに専用の関数を用意します。セキュリティ保護のため、Vercel cron secretを利用して正当なリクエストか検証するロジックが必須です。

APIエンドポイント：定期実行処理の入り口として機能
認証：AuthorizationヘッダーのVercel cron_tokenを照合して不正アクセスを防止
安全な比較：トークンの検証にはcrypto.timingSafeEqual()を使用

②：App Routerで定期処理を実装する

App Router環境では、Route Handlersを用いてGETメソッドでロジックを記述します。DBのバックアップやキャッシュ更新など、自動化したいタスクをここに定義してください。

実行時はステータスコード200を返し、処理が完了したことをシステムに伝えます。サーバーレス関数のタイムアウト制限があるため、長時間かかる処理は工夫が必要です。

項目	内容
使用メソッド	GET
推奨ランタイム	EdgeまたはNode.js
主な用途	DBクリーンアップ、外部API取得、通知配信
成功時の応答	NextResponse.json({ ok: true })

③：vercel.jsonでジョブを定義する

プロジェクトのルートにあるvercel.jsonを使い、実行パスと頻度を定義します。この設定によりVercelがスケジュールを認識し、指定時間にAPIを呼び出す仕組みです。

複数のタスクを動かしたい場合は、リスト形式で複数のジョブを記述できます。Vercel cron job preview機能を活用し、デプロイ前に設定内容が正しいか確認しておくと安心です。

配置場所：プロジェクトのルートディレクトリ
記述形式：cronsプロパティ内にpathとscheduleを記述
設定のコツ：実行したいAPIパスを正確に指定

④：Cron式でスケジュールを指定する

スケジュールの設定には「分・時・日・月・曜日」の5つで構成されるCron式を使います。特定の日時や周期を細かく指定できるため、柔軟な運用が可能です。

VercelはUTC（協定世界時）を採用している点に注意してください。日本時間で動かす場合は、9時間の時差を計算して記述する必要があります。

毎時0分に実行：0 * * * *
日本時間の午前2時に実行：0 17 * * *（UTCの17時）
平日のみ実行：0 10 * * 1-5

⑤：デプロイして実行を確認する

設定を反映させるため、リポジトリへコミットしてVercelデプロイの手順に沿って公開を行います。VercelダッシュボードのSettingsからCron Jobsを開き、各項目が正常に登録されたか確認してください。

もしVercel cron job not workingという状態であれば、ログを確認しましょう。Vercel Cron 無料枠（Hobbyプラン）は実行回数に制限があるため、Vercel Cron 料金プランごとの差異を確認することも大切です。

GitHubへプッシュして自動デプロイを完了させる
ダッシュボードでステータスがEnabledかチェック
手動でAPIを叩きテスト実行を行う
Logsメニューで実行エラーの有無を監視

Vercel Cronのセキュリティ対策

Vercel Cronを利用してタスクを定期実行する場合、セキュリティ対策は極めて重要な要素です。Cronジョブは指定したURLへHTTPリクエストを送る仕組みのため、防御策を講じないと外部からの不正操作を招く恐れがあります。

セキュリティを確立するには、Vercel cron secretを用いたトークン認証の実装が推奨されます。Vercelが自動付与するシークレット値とAPI側での検証ロジックを組み合わせ、正当なリクエストのみを受理する構成にしましょう。

未認証アクセスを防ぐ理由

Vercel Cronの実行対象となるAPIルートは、インターネット上に公開されたURLです。適切な認証を実装していない場合、URLを知っている第三者が手動でリクエストを送り、Next.js cronの処理を勝手に実行できてしまいます。

リスク項目	内容の詳細
リソースの乱用	サーバーレス関数の実行時間やデータベース接続などのコストが急増する
データの不整合	不適切なタイミングで処理が走り、データの整合性が崩れる
セキュリティ侵害	機密データを扱うAPIが露出している場合、情報漏洩の起点となる

リソースを守るため、Vercelからの正当な呼び出しであることを証明する認証が不可欠です。

環境変数によるシークレット設定

認証実装の第一歩は、プロジェクト設定でVercel環境変数の設定としてVercel cron secretを管理することです。Vercelには、Cron実行時に認証ヘッダーを自動で付与する便利な仕組みが備わっています。

Vercelのプロジェクト設定からEnvironment Variablesを開く
CRON_SECRETという名前で任意の文字列を環境変数に登録する
実行時、リクエストヘッダーにAuthorization Bearer形式で自動付与される

このVercel cron_tokenの仕組みにより、コード内にパスワードを直接書く必要がなくなります。安全に認証情報を管理できるため、必ず設定してください。

APIルートでのリクエスト検証

Vercelからリクエストを受信する側のAPIでは、ヘッダーが正しいか検証するコードが必要です。Next.jsのAPIルートにおいて、届いたトークンと環境変数が一致するかを調べます。

Authorizationヘッダーを取得し、Bearerスキームを確認する
環境変数のCRON_SECRETとリクエストされた値を比較する

トークンが一致しない場合は401エラーを返し、即座に処理を中断してください。この検証を省略すると、Vercel cron job not workingの原因特定も困難になるため、正確に実装することが重要です。

不正アクセスを防ぐベストプラクティス

Vercel Cronを安全に運用するには、認証の実装だけでなく継続的な管理が必要です。多層的な防御を組み合わせることで、システムの堅牢性はさらに向上します。

シークレットの定期更新：定期的にトークンを変更し、漏洩時のリスクを最小限に抑える
実行環境の制限：Vercel cron job preview環境など、必要のない場所では実行を制限する
ログの監視：異常な実行回数や認証失敗のログが頻発していないかチェックする

これらの対策を徹底すれば、Vercel単体でも安全な定期実行システムを構築可能です。コストを抑えつつ、セキュアなインフラ環境を実現しましょう。

Vercel Cronの実践的なテスト手法

Vercel Cronは、サーバーレス環境でタスクを定期実行するための便利な機能です。本番環境でしか動作しない特性があるため、開発時は適切なテスト手法を学ぶ必要があります。

ローカル環境やプレビュー環境での検証、トラブルシューティングまで実践的なプロセスを解説します。

ローカル環境でのデバッグ方法

Vercel Cronの自動トリガーは本番限定のため、ローカルではスケジュール機能そのものは動きません。Next.js cronの実装を確認する場合は、Vercel CLIでローカル検証を行い、対象のAPIエンドポイントを直接呼び出してロジックを検証します。

具体的な手順は以下の通りです。

app/api/cron/route.tsなどのAPIルートを作成する
ローカル実行時は認証チェックをスキップするよう実装を調整する
curlコマンドやツールを使い、エンドポイントへリクエストを送る

リポジトリ管理を活用してデプロイを自動化したい場合はVercelとGitHub連携も併用するとスムーズです。環境ごとの認証ロジックや実行トリガーの差分は、下表を参考に把握してください。

項目	ローカル環境	本番環境
実行トリガー	手動実行	自動実行
認証チェック	スキップ可能	CRON_SECRETによる比較
ログ確認	ターミナル	Vercelダッシュボード

プレビュー環境での実行

GitHubのプルリクエストで生成されるVercel cron job preview環境では、自動実行は行われません。ただし、デプロイされたAPIの動作を本番に近い状態で手動確認することは可能です。

プレビュー環境でのテストは、以下の手順で進めます。

VercelダッシュボードのCron Jobs設定が有効か確認する
環境変数にVercel cron secretが正しく設定されているか見る
ダッシュボードからトリガーを手動で実行する

Hobbyプランなどはタイムアウト制限が短いため、事前にリソース制限下での挙動を把握することが大切です。

エラー時のトラブルシューティング

Vercel cron job not workingという状況に陥った場合、その原因の多くは認証エラーや設定不備です。Vercel cron_tokenの扱いや設定ファイルをまず確認してください。

よくある原因と解決策は以下の通りです。

401 Unauthorized：Authorizationヘッダーの値がCRON_SECRETと一致していない
200以外のレスポンス：実行失敗とみなされるため、エラー時も適切なハンドリングが必要
設定の反映漏れ：vercel.jsonへの記述だけでなくダッシュボードで有効化されているか確認

トラブル時はFunctionsカテゴリのログを注視し、実行時間やメモリ使用量に異常がないか探します。

制限を回避する代替手法

Vercel Cron 料金はプランごとに異なり、無料で使えるHobbyプランには実行回数の上限があります。Vercel Cron 無料枠でコストを抑えたい場合は、制限内容を事前に把握しましょう。

プランごとの月間実行回数の上限は次の通りです。

Hobby（無料）：1,000回まで
Pro：10,000回まで

実行頻度が非常に高い場合は、Npm cronなどを活用して外部からリクエストを送る方法もあります。GitHub Actionsのスケジュール機能でAPIを叩けば、ネイティブの制限に縛られず柔軟に運用可能で、バッチ結果を蓄積する用途にはVercel PostgresでバッチDBを組み合わせるのも有効です。