Miniflare v5 の変更点、直接依存するコードだけ破壊的変更で wrangler dev 経由は対応不要

Miniflare は、wrangler dev などの裏で Cloudflare Workers をローカル実行している部品だ。Cloudflare は 2026年9月8日、Workers の変更履歴でその Miniflare v5 を告知した。wrangler dev、Cloudflare Vite plugin、@cloudflare/vitest-plugin を通してローカルで Workers を動かしているプロジェクトは、変更履歴の記述に従えば今日やることはない。確認が要るのは、Miniflare をパッケージとして直接依存に持ち、その API やオプションを自分のコードから呼んでいるプロジェクトに限られる。

変更履歴はこの版を、控えている cf CLI に向けてローカル開発ツールの土台を整える版だと位置づけている。中身は、設定の形の変更を筆頭に、古い API やオプションの削除などの破壊的変更だ。

大半のプロジェクトは Miniflare を直接触っていない

Miniflare は wrangler dev、Cloudflare Vite plugin、@cloudflare/vitest-plugin の裏でローカル実行を担っている。変更履歴は、ほとんどのプロジェクトは Miniflare に直接依存せずこれらのツールを使うべきで、Miniflare v5 は対応を求めないと書いている。

裏を返せば、確認が要るのは Miniflare に直接依存しているプロジェクトだ。どの版の wrangler や Vite plugin が v5 を取り込むのか、取り込んだときに上位ツール側の挙動が変わるのかは、この投稿には書かれていない。

設定の形が cloudflare.config.ts に寄る

最も大きい変更は設定の形だ。Miniflare の設定が cloudflare.config.ts に揃う。変更履歴はこれを、テスト向けに使えるようになったプログラム的な Cloudflare 設定形式だと説明している。

新旧のオプション名や移行例は投稿に載っていない。Miniflare を直接呼ぶコードは、設定オブジェクトの形が変わることを前提に、v5 へ上げる前に手元で組み立てている設定を洗い出しておく必要がある。上位ツールに載せ替えられるなら、それが変更履歴の勧める道でもある。

消える API と、動く経路

設定形式のほかに、投稿は 5点の破壊的変更を挙げている。

• 非推奨だった API とオプションの削除。例として legacy alpha D1 bindings が挙がっている
• 使われなくなった内部 API の削除。wrappedBindings が例に出ている
• Miniflare 組み込みのモジュール探索の削除。モジュールグラフは Wrangler や Vite plugin のような上位ツールが渡すものになる
• ローカル専用の /cdn-cgi ルートを /cdn-cgi/local 配下へ移動
• リソースごとの永続化オプションを、共有の永続化ルートオプションに置き換え

投稿自身が、この一覧は全部ではないと断っている。ここに挙がっていない変更が v5 に含まれている可能性は残る。

モジュール探索を Miniflare に任せていたコードは、その探索が v5 で消える。代わりにモジュールグラフを渡す側として投稿が挙げるのは、Wrangler や Vite plugin のような上位ツールだ。/cdn-cgi をローカルで叩くテストやスクリプトは、パスが /cdn-cgi/local に変わる。どのルートが対象なのかは投稿に列挙されていない。永続化先をリソースごとに分けていた設定は、共有のルートを指す形に書き直すことになるが、新しいオプション名も投稿にはない。

alpha 期の D1 バインディングをまだ使っているなら、そこでも止まる。非推奨のまま残っていたものが v5 で消える。

cf CLI について投稿が言っていること、言っていないこと

変更履歴はこの一連の変更を、次世代のローカル開発ツールのための土台だと位置づけ、その一つとして新しい cf CLI を挙げている。cf CLI そのものについて投稿が言うのは「今後出る」ということだけだ。何ができるのか、wrangler と置き換わるのか、いつ出るのかは書かれていない。

上げる前に見る場所

Miniflare を直接依存に持つプロジェクトなら、v5 に上げる前に次を見ておく。

1. 依存に miniflare が直接入っているか。入っていなければ、この先の確認は要らない
2. Miniflare の設定オブジェクトを組み立てている箇所。形が変わる
3. /cdn-cgi を叩いているテストやスクリプト。/cdn-cgi/local へ移る
4. リソースごとの永続化オプションと、alpha 期の D1 バインディング

載せ替え先があるなら、wrangler dev、Vite plugin、@cloudflare/vitest-plugin のどれかに寄せるのが変更履歴の勧める形だ。Miniflare v5 とは別件だが、同じ Workers の変更履歴には 9月4日付でデプロイ時のサイズ上限の統一も載っている（サイズ上限の変更）。