Fastify v5アップデート：Node.js 20の要件と主な変更点のまとめ

Fastifyの5回目のメジャーバージョンとなるv5が正式リリースされました。高い処理能力と軽量なアーキテクチャによりNode.jsエコシステムで広く使われているWebフレームワークだけに、今回のバージョンアップが既存コードにどのような影響を与えるのかを確認しておく必要があります。

Fastify v5は、レガシーなランタイムとの互換性を大胆に排除し、最新のNode.js環境における標準診断ツールと完全なスキーマ定義を中心にフレームワークを整理しました。

ランタイムの最小仕様を引き上げ：Node.js 20以上が必須

Fastify v5における最大の変更点は、最小動作環境です。Node.js 18のサポートを完全に終了し、Node.js 20以上のバージョンを必須要件としました。v4の長期サポート期間が終了に差し掛かる中で、ランタイムの最新のパフォーマンス改善や内蔵診断ツールを積極的に活用するための決定です。

プロジェクトをFastify v5に移行する前に、サーバー環境やコンテナのベースイメージがNode.js 20以上であることを確認する必要があります。旧バージョンのNode.jsで実行しようとすると、インストールや実行段階でエンジンの互換性に関する警告が出たり、起動に失敗したりします。

jsonShorthandの廃止と厳格化されたJSON Schema

ルート検証において非標準の短縮表記であったjsonShorthandのサポートが完全に削除されました。Fastify v4までは、クエリやボディのスキーマを宣言する際、最上位のtype: 'object'を省略する短縮表記が一部許可されていました。v5からは、スキーマ仕様に明確に従った完全なJSON Schemaオブジェクトのみが許可されます。

Fastify v5の公式ドキュメントに基づき、スキーマでは以下のように最上位のタイプを明示的に記述する必要があります。

既存プロジェクトに短縮型のスキーマが残っていると、Fastifyインスタンスの初期化時にコンパイルエラーが発生するため、ルート定義全体でスキーマ構造を点検する必要があります。

node:diagnostics_channelの統合による可観測性の改善

アプリケーション監視の領域では、Node.js内蔵の診断チャネルであるnode:diagnostics\_channelとの連携が正式に導入されました。サードパーティ製プラグインやモンキーパッチを使わなくても、HTTPリクエストの受信、ルーティング、応答終了といったライフサイクル全体を標準診断イベントとして購読できます。

OpenTelemetry連携ライブラリや分散トレーシングシステムを構築する際、オーバーヘッドを低減しながら精度の高い測定値を取得できるようになりました。

応答時間の計測およびネットワークプロパティの整理

使用頻度が高かった一部のヘルパーメソッドとプロパティも標準化されました。応答経過時間をミリ秒単位で取得していたreply.getResponseTime()メソッドが削除され、reply.elapsedTimeゲッタープロパティに置き換わりました。

古いNode.jsのHTTPオブジェクトの名残であったrequest.connectionへのアクセスも削除されました。ソケット情報が必要な場合はrequest.socketまたはrequest.raw.socketを直接参照してください。内部ルーターであるfind-my-wayとの整合性を高めるため、fastify.hasRoute()のパス照合ルールも、ルーターの実際の動作方式と同一になるよう統一されました。

導入の判断と開始方法

新規Node.jsサービスの構築準備中であれば、Node.js 20または最新のLTS環境上でFastify v5を使用して開始するのが自然です。基本構造がより厳格化されたため、設計段階から標準のJSON Schemaを適用し、型安全性を確保しやすくなっています。

運用中のFastify v4プロジェクトを移行する場合は、以下の2点を順に確認すれば十分です。実行サーバーのNode.js 20へのアップデートの有無を点検し、ルート定義に残っている短縮型スキーマとreply.getResponseTime()の呼び出し箇所を検索して修正することで、移行作業を完了できます。