本文へスキップ

ブログクラウド・運用

VercelのNext.jsをCloudflare Workersへ移すと、何が動かなくなる?

Vercelで動かしていたNext.jsを、OpenNextでCloudflare Workersへ移しました。node:fsが読めずに空になった一覧・NEXT_PUBLIC_の変数の置き場所・デプロイのたびに変わるworkers.devとCustom Domainsなど、3つのプロジェクトで詰まったところと切り替えの判断をまとめます。

左の台から右の台へ積み木を運ぶ図。右で積み直した中に、空いた枠とずれた積み木がある。

2026年10月の終わりに、Vercelで動かしていたNext.jsのプロジェクトをCloudflare Workersへ移しました。対象はこのサイト(cyfr.dev)と社内プロダクト、それに私が提供しているSaaSのmisenoworkの3つです。どれもOpenNext(@opennextjs/cloudflare)のアダプターで、Next.jsのままWorkersに載せました。もう1つのサイトは、静的エクスポートしてWorkersのStatic Assetsで配信しています。

切り替えは、どれも10月31日の1日で終わりました。手間がかかったのは、エラーを出さずに止まった処理とデプロイのたびに変わる設定のほうです。この記事では詰まったところと、切り替えで決めたことを書きます。バージョンや既定値は2026年10〜11月時点のものです。社内プロダクトの名前と、misenoworkの利用者が分かる情報は伏せています。

移した理由はチーム単位の固定費

VercelはProプランで、月20ドルでした。Proの料金はプロジェクト数ではなく、チームのシート数で決まります。1つのプロジェクトだけ移しても固定費は減らず、同じチームのプロジェクトを全部移して初めて解約できます。開発者を1人増やす予定もあり、そのままなら月40ドルになるところでした。

CloudflareはすでにWorkers Paid(月5ドル)を契約していたので、移しても追加の費用はかかりません。費用に加えて、使うプラットフォームをCloudflareに寄せて単純にしたい考えもありました。

最短で移せるOpenNextを選んだ

候補は3つありました。

図1 検討した移行方式

方式中身判断
OpenNextnext buildの成果物をWorkers向けに変換するアダプター採用。Next.jsのコードをほとんど変えずに移せる
vinextNext.jsのAPIをViteの上で実装し直したもの見送り。Cloudflare自身がExperimentalと明記している
静的エクスポートoutput: "export"で全ページをHTMLにする見送り。misenoworkは139ルート中64ルートが動的ルートで、書き出せない

vinextには互換性チェックのコマンドがあり、このサイトは95%と出ました。ただ、このチェックが見るのはimportと設定を解決できるかどうかです。後で書くVERCEL_ENVに頼った処理が黙って止まる問題は、チェックでは出てきませんでした。

OpenNextの欠点は、Next.jsの新しいバージョンが出るたびに対応を待つことです。実際にOpenNextはNext.js 16.4.1以上を要求しました。先にNext.jsを16.1.6から16.4.3へ上げてVercelの本番に出し、それから移しました。

エラーを出さずに止まった処理

node:fsで読んでいた一覧が空になった

このサイトでは、問い合わせページにプロダクトの一覧を出しています。一覧は、ランタイムでnode:fsを使ってcontent/のMarkdownを読んで作っていました。Workersのランタイムではこのファイルを読めず、一覧は例外も出さずに0件になりました。

next.config.tsでビルド時に中身を埋め込む形に変えて、0件から3件に戻りました。ページは200を返すのでステータスやログでは気づけず、移したあとはworkers.devのURLで18ページを開いて中身を見ています。

サーバー側のSentryがリクエストのたびに例外を出していた

misenoworkでは、@sentry/node-coreが読み込み時にWebAssembly.compileを呼んでいました。workerdではこの呼び出しが禁止されていて、リクエストのたびにunhandledRejectionが出ます。

ここでもページは200を返していました。サーバー側のSentryの設定(sentry.server.config.ts・sentry.edge.config.ts・instrumentation.ts)を外し、クライアント側のSentryだけを残しました。

VERCEL_ENVに頼った処理が止まった

このサイトではGoogleタグマネージャーとTurnstileを、Vercelが注入するVERCEL_ENVで本番かどうか判定していました。Workersにはこの環境変数がないので判定が常に「本番以外」になり、どちらも黙って止まります。

書き換える前のコードで57件中2件が落ちるテストを先に足し、NODE_ENVとホスト名で判定する形に書き換えました。

Workers Buildsで詰まったところ

Workers Buildsは、GitHubへのpushでビルドとデプロイを走らせるCloudflareのCI/CDです。VercelのGit連携の代わりに使いました。misenoworkでは、切り替えから数日後に設定しています。

既定のpnpmが9.10.0

Workers Buildsのpnpmは、指定しなければ9.10.0でした。手元とGitHub Actionsはpnpm 10で、pnpm-workspace.yamlもpnpm 10でしか通らない書き方になっていました。そのためmisenoworkの最初のビルドは、pnpm install --frozen-lockfileがpackages field missing or emptyで失敗しました。package.jsonのpackageManagerを書くと、Workers Buildsはそのバージョンを使います。

json

{
  "packageManager": "pnpm@10.28.1"
}

pnpmのminimumReleaseAge(公開から一定期間たっていないパッケージを入れない設定)にも当たりました。出たばかりのOpenNext 1.20.15とwrangler 4.156.0が弾かれ、それぞれ1.20.14と4.153.0に固定しています。

NEXT_PUBLIC_はビルド変数に入れる

NEXT_PUBLIC_で始まる変数は、next buildのときにクライアントのJavaScriptへインライン展開されます。Workersの設定画面には「ビルド変数」と「変数とシークレット」(ランタイム)の2か所があり、ランタイム側に入れてもビルドには渡りません。社内プロダクトでは、ランタイム側に入れたためにビルド時のチェックで失敗しました。

下の図は、2か所に入れた変数がどこへ渡るかを示したものです。

Workersの設定画面の変数の図。ビルド変数はnext buildに渡り、クライアントのJavaScriptへインライン展開される。変数とシークレット(ランタイム)はWorkerのランタイムにだけ渡り、ビルドには渡らない。

misenoworkでは、APIのベースURLをNEXT_PUBLIC_の変数で持っています。ここが欠けると全画面がAPIにつながらなくなるので、最初のビルドで配信されたJavaScriptにベースURLが入っているかを見ました。

ビルドコマンドは空にする

opennextjs-cloudflare buildは、内部でnext buildを実行します。Workers Buildsのビルドコマンドにpnpm run buildを残すと、next buildが2回走ります。ビルドコマンドは空にして、デプロイコマンドのpnpm run deploy(opennextjs-cloudflare build && opennextjs-cloudflare deploy)だけにしました。

ダッシュボードで設定したプレーンテキストの変数は、デプロイのたびに消えるおそれがあるという警告も出ました。シークレットでない値はwrangler.jsoncのvarsに書いています。

切り替えとデプロイのたびに変わるドメイン設定

既存のDNSレコードがあるとCustom Domainを追加できない

WorkerにCustom Domainを付けるには、同じホスト名のDNSレコードを先に消す必要があります。残っていると、追加がcode 100117で失敗します。レコードを消してからCustom Domainが有効になるまでは、つながらない時間ができます。

このサイトは次の順で切り替えました。

cyfr.devの切り替え手順の図。1. wwwからapexへのRedirect Rule(308・クエリ文字列を保持)を作る。2. Vercelを指していたapexのAレコードを消す。3. WorkerにCustom Domainとしてcyfr.devを追加する。4. wwwのレコードをプロキシ有効のAAAA(100::)に置き換える。5. Always Use HTTPSとHSTSを有効にする。2から3が有効になるまでのあいだは、つながらない時間になる。

Vercelはhttpからhttpsへのリダイレクトを自動でしていました。CloudflareではAlways Use HTTPSを有効にしないとリダイレクトされません。社内プロダクトでは切り替えた直後にhttp://へのリクエストが200を返していて、設定を足しました。

workers.devがデプロイのたびに有効に戻る

Workerには<Worker名>.<サブドメイン>.workers.devのURLが付きます。Custom Domainがあれば不要です。ところが、ダッシュボードで無効にしても次のデプロイで有効に戻ります。

wranglerはwrangler.jsoncにroutesがなければworkers_devの既定値をtrueにして、デプロイのたびにworkers.devを有効化します。ダッシュボードで付けたCustom Domainは、この判定に数えられません。workers_devとpreview_urls(バージョンごとのプレビューURL)を、どちらも明示的にfalseにして直しました。

jsonc

{
  "workers_dev": false,
  "preview_urls": false
}

routesに残したままデプロイすると手で作ったDNSレコードが消える

misenoworkでは、routesにwwwをcustom_domain: trueで書いていました。wranglerはデプロイのたびに、ここにあるホスト名をCustom Domainとして作り直します。wwwはリダイレクトにしか使わないので、Workerから外してAAAAレコードとRedirect Ruleで受けるつもりでした。

起きたのは次の流れだと考えています。

wwwのDNSレコードの移り変わりの図。最初はWorkerのCustom Domainだった。Custom Domainsからwwwを外すとレコードはなくなり、AAAAレコードを手で作った。routesにwwwが残ったままデプロイが走り、wranglerが付け直してWorker管理のレコードに置き換わった(推定)。Custom Domainsからもう一度wwwを外すと何も残らず、NXDOMAINになった。

wwwはNXDOMAINになり、Redirect Ruleまで届かなくなりました。misenoworkは移行のときに正規のホストをwwwからapexに変えていて、前から配っていたリンクはwwwのままでした。そのため、wwwのリンクから開いた人が入れなくなりました。

監査ログまでは確かめていないので、デプロイでAAAAレコードが消えたところは推定です。AAAAレコードを入れ直して復旧しました。いまはroutesからwwwを外し、DNSを触ったあとはdigで名前が引けるかを確かめています。

Vercelを当日に消した判断

Vercelのプロジェクトを残しておけば、DNSを戻すだけで数分で切り戻せます。それでも移行を始めたときから、よほど残す理由がなければ消すつもりでいました。

実際に、3つのプロジェクトとも切り替えた日にVercelから消しました。利用者が少なく、移したものはもう動く見込みが高いと考えていました。何か起きても、ほとんどはWorkers側で直せば済むとも思っていました。

消したあとの切り戻しは、Workersのデプロイ履歴から前のバージョンへロールバックする形になります。ただ、Custom Domainsはバージョンの管理対象に入っていません。ロールバックしても、外したCustom Domainは戻りません。

TTFBはどう変わったか

このサイトのTTFBを、手元から5回ずつ測りました。

図2 このサイトのTTFB(OpenNextで移した直後)

ページVercelWorkers
静的ページ約50〜60ミリ秒約80〜100ミリ秒
問い合わせページ(SSR)約235ミリ秒約90ミリ秒

misenoworkでは、ビルド時にプリレンダーしたページをOpenNextのキャッシュから返す設定にしました。opennextjs-cloudflare previewで手元で動かしたとき、/の応答は146ミリ秒から8ミリ秒になっています。Workerのサイズはgzip後3.57MBで、Workers Paidの上限10MBに収まっています。

このサイトは翌日Astroに作り直した

このサイトは、OpenNextで移した翌日にAstroで作り直しました。ほとんどが静的ページなので、Next.jsのままでいる理由が薄かったからです。

OpenNextでNext.jsのまま移したのは、最短で移すためでした。先にNext.jsのまま移して動かし、そのあとフレームワークを変えています。

社内プロダクトとmisenoworkは、いまもOpenNextで動かしています。

移す前に確かめること

図3 移す前に確かめること

確かめること見る場所
ランタイムでファイルを読んでいないかnode:fsの呼び出し。移したあとは、そのデータを使うページを開いて中身を見る
Vercelの環境変数に頼っていないかVERCEL_ENV・VERCEL_URLなどの参照
サーバー側の依存がworkerdで動くかSentryなどのSDK。ページが200でも、ログに例外が出ていないかを見る
NEXT_PUBLIC_をどこに入れるかWorkers Buildsのビルド変数
routes・workers_dev・preview_urlsを明示しているかwrangler.jsonc。書いていないと、デプロイのたびにドメイン設定が変わる
httpからhttpsへリダイレクトされるかCloudflareのAlways Use HTTPS
切り戻しの手段Vercelを残す期間。消したあとはWorkersのロールバックで戻せるが、Custom Domainsは戻らない

作っているものや動かしているもので迷ったら、エンジニアに直接相談できます。自分たちでもプロダクトを作って運用している私たちが、状況を確かめるところから直して動かし続けるところまで一緒に進めます。

エンジニアの相談窓口を見る
ブログ一覧へ戻る