この変更が意味すること
NestJS v11.1.24 は、core モジュールのバグ修正と機能強化、および platform-ws の依存関係更新を含む通常のパッチリリースです。
最も影響が大きい変更は、メタデータ変更時に dependency-tree キャッシュがリセットされないバグの修正です。この問題は特定の条件下でアプリケーションが古いモジュールグラフを参照し続けるという症状を引き起こしていました。dynamic module や forRootAsync パターンを多用するプロジェクトで意図しない挙動が発生していた場合、このリリースで改善される可能性があります。
breaking change はなく、v11.1.23 からの安全なアップグレードです。
主な変更点
バグ修正: dependency-tree キャッシュのリセット問題（core）
メタデータが変更された際に、core モジュール内の dependency-tree キャッシュが正しくリセットされない問題が修正されました（#17009）。
この問題は、動的モジュールや forRootAsync などのファクトリーパターンを使用し、実行中にメタデータが変化するケースで影響が出る可能性がありました。
機能強化: WebSocket アダプターの遅延登録に対する警告（core）
WebSocket アダプターがアプリケーション初期化後に登録された場合、警告メッセージを出力するようになりました（#16997）。
WebSocket アダプターはアプリケーション起動前に登録する必要があります。この変更により、遅延登録が発生した際に開発者が問題に気づきやすくなります。
依存関係: ws 8.20.1 → 8.21.0（platform-ws）
platform-ws パッケージが使用する ws ライブラリが 8.20.1 から 8.21.0 にバンプされました（#17011）。
EOL / サポート状況
NestJS は endoflife.date での公式サイクル追跡対象外です。npm の dist-tags を参照してください。
| タグ | バージョン |
|---|---|
| latest | 11.1.24 |
| next (alpha) | 12.0.0-alpha.5 |
| legacy | 10.4.22 |
NestJS 12 のアルファ版が next タグで公開されています。次世代APIの変化に備えてリリースノートを追っておくと良いでしょう。
開発者への影響
- 動的モジュールを多用するプロジェクト: dependency-tree キャッシュのバグ修正により、特定条件での意図しない挙動が解消される可能性があります。
- WebSocket 利用プロジェクト: アダプターの遅延登録がある場合、警告が表示されるようになります。起動順序の見直しを推奨します。
- platform-ws 利用者:
wsのマイナーバンプですが、動作確認を行っておくと安心です。 - それ以外のプロジェクト: 通常のアップデートサイクルで問題なく適用できます。
アップデート方法
# npm
npm install @nestjs/core@11.1.24 @nestjs/common@11.1.24
# yarn
yarn add @nestjs/core@11.1.24 @nestjs/common@11.1.24
# pnpm
pnpm add @nestjs/core@11.1.24 @nestjs/common@11.1.24
NestJS はモノレポ構成のため、@nestjs/core と @nestjs/common を同バージョンに揃えて更新してください。
データソース: GitHub Releases API, npm Registry AI解説は Claude API により自動生成されています。正確性については原文をご確認ください。