# NATS v2.11.11

2025-11-13 · [元のリリースノート](https://github.com/nats-io/nats-server/releases/tag/v2.11.11) · [全体のまとめ](https://ratatosk.io/ja/releases/nats/v2.11.11)

重大な修正 28 · 機能・改善 7 · 依存関係の更新 6 · その他の変更 16

## アップグレード前の確認事項

### アップグレードガイド

- **2.10.x との互換性に関する 2.11 へのアップグレードガイド**
  > Refer to the [2.11 Upgrade Guide](https://docs.nats.io/release-notes/whats_new/whats_new_211) for backwards compatibility notes with 2.10.x.

  - マイナーバージョン間のアップグレードガイド

## 重大な修正 (28)

### [表面化しなかった不具合] JetStream ストリームのキャッチアップ中のヘルス報告を修正

- 影響対象: キャッチアップ中の JetStream ストリーム

ストリームのキャッチアップ中は、キャッチアップが完了するまで Raft の状態が進まないため、ヘルスチェックが `group node unhealthy` と報告していました。ヘルスチェックはキャッチアップ状態を先に確認し、`stream catching up` と報告するようになりました。

> - Healthchecks now correctly report when streams are catching up, instead of showing them as unhealthy (#7535)

### JetStream filestore の secure erase 時に tombstone が失われる問題の修正

- 影響対象: JetStream filestore で secure erase を使用する構成

ブロック内の tombstone より前にあるメッセージを消去した後、インデックスの再構築が必要となる異常終了が発生すると、tombstone が失われ、削除済みメッセージが復元される可能性がありました。このケースでも filestore が tombstone を保持するようになりました。

> - The filestore no longer loses tombstones when using secure erase (#7384)

### JetStream filestore の復旧時におけるシーケンス巻き戻りの修正

- 影響対象: tombstone のみを含むブロックを復旧する JetStream filestore 構成

メッセージの確認応答後、対応する tombstone が新しいブロックにあふれ、元のメッセージブロックが削除された状態で異常終了後に再起動すると、既知の tombstone のシーケンスとタイムスタンプの最小値が使われ、ストリームのシーケンスが巻き戻ることがありました。tombstone が複数のブロックにまたがる場合、空のストリームに低すぎる最初のシーケンスが割り当てられることもありました。この場合、復旧処理では既知の tombstone のシーケンスとタイムスタンプの最大値を使うようになりました。

> - The filestore no longer loses the last sequence when recovering blocks containing only tombstones (#7384)

### ストリームレプリカにおける順不同の `SkipMsg` 処理の修正

- 影響対象: レプリカを持つストリーム

ストリームのレプリカが順不同の `SkipMsg` を受信すると、本来スキップすべきでないメッセージにスキップ済みの印を付けて削除し、ストリームの同期がずれることがありました。適用前にスキップシーケンスの順序を確認するようになり、キャッチアップ中に同期がずれるのを防ぎます。

> - Skipped message sequences are now checked for ordering before apply, fixing a potential stream desync on catchups (#7400)

### フィルストアの消去済みメッセージのギャップ追跡を修正

- 影響対象: フィルストアを使用する JetStream ストリーム (推定)

フィルストア内のメッセージのギャップが消去済みの最後のメッセージで終わる場合、消去されたスロットが削除として登録されず、キャッシュが継続的に無効化され、読み取りやキャッチアップが遅くなり、削除の追跡も不正確になっていました。状態の再構築時に、欠落しているシーケンス番号を削除として登録するようになりました。

> - Skipped message sequences now correctly detect gaps from erased message slots, fixing potential cache issues, slow reads and issues with catchups (#7399, #7401)

### Filestore のシーケンスギャップ削除追跡の修正

- 影響対象: filestore を使用する JetStream ストリーム

複数の `SkipMsgs` を含むブロックが開始時点で空、または完全に空の場合、再構築時に、スキップによってシーケンス番号が進むだけであるにもかかわらず、シーケンスのギャップが削除済みメッセージとして `dmap` に記録されることがありました。再構築時に、こうしたギャップは削除済みメッセージのマップに含まれなくなりました。

> - Skipped message sequences now correctly detect gaps from erased message slots, fixing potential cache issues, slow reads and issues with catchups (#7399, #7401)

### Raft ピアアクティビティ報告の修正

- 影響対象: API、アセット情報、監視エンドポイントでの Raft グループおよびピアアクティビティの報告

リーダーの変更やクラスターのサイズ変更後も古いアクティブ時刻が更新されず、「最終確認時刻」や「アクティブ」の値が実態と異なる場合がありました。このリリースではピアのアクティビティをより一貫して追跡し、リーダーの変更時に古い時刻をクリアするため、報告される値が前のリリースと異なる場合があります。

> - Raft groups now report peer activity more consistently, fixing some cases where asset info and monitoring endpoints may report misleading values after leader changes (#7402)

### キャッチアップ後に Raft フォロワーの WAL が切り詰められる問題の修正

- 影響対象: 並行してキャッチアップを実行する Raft フォロワー

複数のキャッチアップが並行して実行されていると、完了後に別のキャッチアップから遅れて届いた append をフォロワーが受け入れ、コミット可能と報告済みの WAL エントリーを切り詰めることがありました。キャッチアップ完了後に予期しないキャッチアップエントリーを受信しても、WAL は切り詰められなくなりました。

> - Raft groups will no longer permit truncations from unexpected catchup entries if the catchup is completed (#7424)

### NATS ヘッダーの接尾辞一致バグの修正

- 影響対象: 共通の接尾辞を持つヘッダーキーを含むメッセージ

`Previous-Nats-Msg-Id` が存在する状態で `Nats-Msg-Id` の取得、削除、設定を行うと、代わりに先にあるキーと値が使われることがありました。

> - A couple of issues related to header handling have been fixed (#7465)

### 既存ヘッダーを正しく更新する `setHeader`

- 影響対象: 既存のヘッダー更新に `setHeader` を使用するコード

以前は、値の先頭に空白がない既存の `k:v` ヘッダーに対して `setHeader` で `k` を設定すると、既存のヘッダーが更新されず、別のヘッダーが追加されていました。

> - A couple of issues related to header handling have been fixed (#7465)

### JetStreamの空ストリームにおける`NoWait`応答の修正

- 影響対象: 有効期限を指定しない`NoWait`リクエストを使用するJetStreamコンシューマー

このようなリクエストがメッセージを配信せずに空のストリームの末尾に達した場合、以前は`404 No Messages`を受信できませんでしたが、現在は受信できます。

> - No-wait requests now return a 400 No Messages response correctly if the stream is empty (#7466)

### Filestore 末尾の欠番補完時に発生するシーケンスエラーの修正

- 影響対象: JetStream filestore

ブロック末尾の欠番を埋める際、1つずれた処理により、あるシーケンスが削除済みとマークされ、最後のシーケンスが見落とされることがありました。

> - An off-by-one when detecting holes at the end of a filestore block has been fixed (#7508)

### [表面化しなかった不具合] リーダーのシャットダウン・降格時におけるRaftクォーラム喪失の誤報を修正

- 影響対象: サーバーがリーダーを務めるRaftグループ

以前は、LDM によるリーダーのシャットダウン時やリーダーの降格時にピアのタイムスタンプが消去され、Raft グループがクォーラムを失ったと報告し、「NO quorum, stalled」と表示してアドバイザリを送信していました。現在は、リーダーは降格後も自身のピアのタイムスタンプを保持します。新しいリーダーが稼働した後は、他のフォロワーのタイムスタンプを引き続き消去できます。

> - Raft groups should no longer report no quorum incorrectly when shutting down (#7522)

### JetStream filestore のブロック末尾の欠落検出を修正

- 影響対象: JetStream filestore (推定)

ブロック末尾の欠落を検出する際、削除マーカーが最後のシーケンスとして扱われ、削除が見落とされることがありました。filestore は、最後に正常と確認されたシーケンスを基準にシーケンスを処理するようになりました。

> - An off-by-one when detecting holes at the end of a filestore block has been fixed (#7525)

### 新規ルート接続でバイナリスナップショットを優先する NATS サーバー

- 影響対象: v2.10.0 以降を実行するサーバーとの新規ルート接続に参加するノード

新たに確立されたルート接続で `STATSZ` が届く前に、サーバーが従来の形式にフォールバックすることがありました。この形式では、中間削除を `[]uint64` で表現するため、中間削除が多いストリームで膨大なメモリを消費する可能性がありました。

> - Binary stream snapshots are now preferred by default for nodes on new route connections (#7479)

### インタレストベースのストリームレプリカの非同期状態からの復旧

- 影響対象: `InterestPolicy` を使用するクラスター化された JetStream ストリーム

コンシューマーの変更によって、サーバー間で異なる論理時刻にインタレストが確立されると、レプリカ間で非同期が発生し、異なる初期メッセージが保存されることがありました。サーバーはこの `noInterest` の非同期を検出し、インタレストのない先頭メッセージを削除できるようになりました。ただし、根本にある順序競合は引き続き発生する可能性があります。

> - Improve interest detection when consumers are created or deleted across different servers (#7440)

### ゲートウェイごとの `hop` ヘッダー破損の修正

- 影響対象: ゲートウェイ間でメッセージトレーシングを使用する構成

メッセージトレーシングを有効にした状態で、ゲートウェイごとに `hop` ヘッダーを設定すると、ヘッダーが破損することがありました。現在は、この問題を起こさずにゲートウェイごとにヘッダーが設定されます。

> - When using message tracing, header corruption when setting the hop header has been fixed (#7443)

### レイムダックモードでの接続数上限エラーの修正

- 影響対象: レイムダックモードを使用するサーバー上で、最大接続数の上限を設定しているアカウント

アカウントの接続数が上限に近い状態でレイムダックモードに入ると、切断済みの接続がカウントに残り、再接続中のクライアントが二重に数えられていました。そのため、まだ再接続を完了していないクライアントに `maximum account active connections exceeded` エラーが返されることがありました。接続数の集計を修正し、二重計上を防ぐようになりました。`s.Shutdown()` によるシャットダウン中は、残りのクライアントを接続数に計上せずに切断できます。

> - Shutting down a server using lame-duck mode should no longer result in max connection exceeded errors (#7527)

### JetStream API ハンドラーの競合状態と nil メタデータによるパニックの修正

- 影響対象: JetStream API ハンドラー（consumer-info の処理を含む）

一部のハンドラーが `cc.meta` をロックせずに参照していたため、競合状態が発生し、nil の場合にはパニックする可能性もありました。該当するハンドラーはロックなしで `cc.meta` にアクセスしなくなり、consumer-info ハンドラーは使用前に nil かどうかを確認します。

> - Race conditions and potential panics fixed in the handling of some JetStream API handlers (#7380)

### ファイルストアの TTL とスケジューリング状態の書き込みでの `sync_always` の尊重

- 影響対象: TTL またはスケジューリング状態ファイルの書き込みに `sync_always` を使用する JetStream ファイルストア

> - The filestore now correctly obeys `sync_always` for writing TTL and scheduling state files (#7385)

### メッセージ削除エラー時の filestore ロック解放

- 影響対象: filestore を使用する JetStream ストリーム (推定)

メッセージの削除中に `slotInfo` または `mb.eraseMsg` がエラーを返した場合、filestore は関連するロックを解放せずに戻ることがありました。現在は、エラーを返す前にロックを解放します。

> - The filestore will now correctly release locks when erasing messages returns an error (#7431)

### JetStream filestore のシャットダウン時の競合状態の修正

- 影響対象: JetStream filestore

シャットダウン中に `index.db` の生成中にロックが再取得されると、インデックスの書き込み後も `fs.StoreMsg` が処理を続行し、再起動時に無効なインデックスが残る可能性がありました。

> - Fixed a race condition in the filestore that could happen between storing messages and shutting down (#7496)

### 並列ストリーム復元時のパニック修正

- 影響対象: 起動時の並列ストリーム復元

起動時に、アクセス時刻サービスが値を登録する前に `ats.Register()` が実行され、「アクセス時刻サービスが起動していません」というパニックが発生することがありました。この場合、`AccessTime()` は初期タイムスタンプを保存して返すようになりました。起動時には、このタイムスタンプがわずかに古い場合があります。

> - A panic that could occur when recovering streams in parallel has been fixed (#7503)

### ストリーム再作成後にJetStreamの監視が正しいRaftグループを使用

- 影響対象: ストリームを再作成した場合の JetStream メタレイヤーリカバリーと、関連するコンシューマー (推定)

ストリームとコンシューマーがメタスナップショットに含まれている状態で、ストリームを削除して異なる設定で再作成すると、監視ゴルーチンが削除済みの Raft グループに属するノードを使用し、正常に機能しなくなることがありました。

> - Fixed a bug on metalayer recovery where stream and consumer monitor goroutines for recreated assets would run with the wrong Raft group (#7510)

### R1からR3へのストリームのスケールアップ時におけるスナップショットのインストール修正

- 影響対象: R1からR3へスケールアップするJetStreamストリーム

スケールアップの途中でJetStreamのキャッチアップに失敗すると、不完全なピアがリーダーになろうとしてストリームの同期がずれる可能性がありました。リカバリーで処理できるようスナップショットがインストールされ、完全に同期するまで新しいピアはリーダーになれません。

> - Scaling up an asset from R1 now results in an installed snapshot, allowing recovery after restart if interrupted, avoiding a potential desync (#7509)

### JetStream の復旧時ヘルスチェックから削除済みコンシューマーを除外

- 影響対象: JetStream のメタレイヤースナップショットの復旧

復旧中にメタスナップショット内のコンシューマーが削除された場合、そのコンシューマーがヘルスチェックに再び現れ、`consumer not found` エラーを引き起こすことがありました。

> - Consumers that existed in a metalayer snapshot but were deleted on recovery will no longer result in failing healthchecks (#7523)

### JetStream のシャットダウン通知競合の修正

- 影響対象: クラスター構成の JetStream

シャットダウン中、複数のゴルーチンがクラスター終了チャネルを待ち受けていると、`monitorCluster()` ではなく別のゴルーチンがシグナルを受け取ることがありました。現在はチャネルを閉じてすべての待ち受け側に通知し、2つ目のチャネルを使ってモニターの終了を待ちます。

> - Fixed a race condition that could happen with shutdown signals when shutting down JetStream (#7536)

### ストリームのパージ時のエラー処理におけるデッドロック修正

- 影響対象: ストリームのパージ (推定)

コンシューマーの状態が一致せず、パージ中にコンシューマーストアの状態を書き込む際にエラーが発生すると、エラー処理で保持中のストリームロックを再取得しようとしてデッドロックすることがありました。現在は、ロックを再取得せずにストリーム名を取得します。

> - Fixed a deadlock that could occur when purging a stream with mismatched consumer state (#7546)

## 機能・改善 (7)

- JetStream のメタレイヤーログにおけるコンパクションしきい値 (利用条件: しきい値によるコンパクションを使用するには、`meta_compact`、`meta_compact_size`、または両方を設定)
- クライアント、ルート、ゲートウェイ、リーフノード向けの `write_timeout` 動作設定
- JetStream メタクラスタのスナップショット統計情報を `/jsz` で公開
- `/jsz` のダイレクトコンシューマー詳細 (利用条件: `direct-consumers=true` クエリパラメーターを指定した `/jsz` リクエスト)
- JetStream キャッチアップログへの経過時間の追加
- サブジェクト変換による再公開で両フィールドの `>` を許可 (利用条件: ストリーム唯一のサブジェクトをマッピングする `SubjectTransform` があり、`RePublish.Source` と `RePublish.Destination` の両方に `>` を指定)
- JSZ による Raft リーダー数の報告 (利用条件: `raft` フラグの設定)

## 依存関係の更新 (6)

ほか6件（いずれもセキュリティへの言及なし）

- `- 1.25.4 (#7520)`
- `- golang.org/x/crypto v0.43.0 (#7423)`
- `- golang.org/x/sys v0.37.0 (#7423)`
- `- golang.org/x/time v0.14.0 (#7423)`
- `- golang.org/x/sys v0.38.0 (#7538)`
- `- github.com/minio/highwayhash 070ab1a (#7539)`

## その他の変更 (16)

- sublist と subject 変換でのアロケーション削減
- Observer Mode の初回起動時ログの明確化
- JetStream filestore の対象メッセージブロックの一括削除
- スナップショットの試行をサーバー終了時に限定
- JetStream 起動時のストリーム並列読み込み
- 親ストリーム起動直後の JetStream コンシューマー起動
- 削除数のより低いしきい値で `LoadNextMsg` を選択
- スケールアップ時のストリームリーダーのキャッチアップ競合の修正
- JetStream の起動・復旧時の並行処理数を `len(dios)` に制限
- ハッシュチェックを `highwayhash.Digest64` に切り替え
- 空の先頭 tombstone ブロックのクリーンアップ
- ミラーコンシューマー設定時のデータ競合を修正
- JetStream filestore で最後のシーケンスを繰り返し読み込む際のキャッシュ期限切れを修正
- NATS のヘッダー処理で `key+":"` の文字列割り当てを回避
- no-op エントリーの適用後にリーダーシップを報告する Raft リカバリー
- JetStream filestore の skip 書き込み中のメッセージブロック mutex 保持

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
