# Dapr v1.17.15

2026-10-08 · [元のリリースノート](https://github.com/dapr/dapr/releases/tag/v1.17.15) · [全体のまとめ](https://ratatosk.io/ja/releases/dapr/v1.17.15)

破壊的変更 3 · 重大な修正 6 · 機能・改善 1 · その他の変更 1

## 破壊的変更 (3)

### Azure Event Hubs ハンドラーの失敗時にチェックポイント前に再試行

- 影響対象: Azure Event Hubs の pub/sub または入力バインディング

ハンドラーが `RETRY` を返した場合、その他の理由で失敗した場合、またはサイドカーのクラッシュやパーティション所有権の喪失時にイベントを処理中だった場合、イベントがチェックポイントに記録され、再配信されないことがありました。現在は、処理が成功するかサブスクリプションがキャンセルされるまで、失敗した処理を設定済みのバックオフに従って再試行します。チェックポイントの進行は、正常に処理されたイベントまたはバッチが連続する範囲に限られます。

> The Event Hubs pub/sub and input binding components now advance a partition's checkpoint only through contiguous, successfully-handled events or batches:
> - A handler failure is retried with the configured backoff until it succeeds or the subscription is cancelled, instead of being dropped and checkpointed anyway.

### Azure Event Hubs の `maxConcurrentHandlers` 上限の追加

- 影響対象: Azure Event Hubs の pub/sub コンポーネントおよび入力バインディングコンポーネント

チェックポイント対象にできない受信済みイベントが100件に達すると、デフォルトでは追加の受信が一時停止します。

> - A new `maxConcurrentHandlers` option (default `100`) bounds how many received-but-not-yet-checkpoint-eligible events can be in flight at once, pausing further receives once the bound is reached.

### Azure Event Hubs のチェックポイント記録に処理成功が必須に

- 影響対象: Azure Event Hubs の pub/sub と入力バインディング

以前は、`enableInOrderMessageDelivery: false` の場合、チェックポイントの記録は配信とは独立した fire-and-forget 方式でした。また、`true` に設定した場合も、ハンドラーが `RETRY` を返してもチェックポイントが記録されていました。

> `enableInOrderMessageDelivery: false` remains the default and continues to control ordering only — it no longer has any bearing on whether a checkpoint requires success.

## 重大な修正 (6)

### [表面化しなかった不具合] Azure Event Hubs のチェックポイント記録に正常な処理が必須に

- 影響対象: Azure Event Hubs の pub/sub および入力バインディングのコンシューマー

`RETRY` イベントや、サイドカーのクラッシュまたはパーティション所有権の喪失時に処理中だったイベントが、エラーなしでチェックポイントに記録され、再配信されないことがありました。ハンドラーの失敗時には設定されたバックオフに従って再試行され、チェックポイントは連続して正常に処理されたイベントまたはバッチの範囲まで進むようになりました。

> - [Azure Event Hubs checkpointed messages regardless of whether the application processed them](#azure-event-hubs-checkpointed-messages-regardless-of-whether-the-application-processed-them)

### [表面化しなかった不具合] Azure Event Hubs のチェックポイント処理の修正

- 影響対象: Azure Event Hubs の pub/sub または入力バインディング

`RETRY` を返したイベントや、サイドカーのクラッシュまたはパーティション所有権の喪失時に処理中だったイベントが、正常に処理されないままチェックポイントに記録され、再配信されないことがありましたが、エラーは通知されませんでした。ハンドラーの失敗は、設定されたバックオフに従って、処理が成功するかサブスクリプションがキャンセルされるまで再試行されます。チェックポイントは、連続して正常に処理されたイベントまたはバッチまで進み、キャンセル後または所有権の喪失が検知された後は進みません。

> You were affected if you consumed messages through the Azure Event Hubs pub/sub component or received events through the Azure Event Hubs input binding.
> An event your application returned `RETRY` for, or one still in flight when the sidecar crashed or partition ownership was lost, was checkpointed and never redelivered, silently downgrading Dapr's documented at-least-once delivery guarantee ("Dapr attempts to redeliver the message until successful delivery") to at-most-once.
> No error was surfaced to the publisher or subscriber when this happened.
> Sibling pub/sub components such as Kafka and Service Bus already conditioned their commit or checkpoint on successful handling; only Event Hubs did not.
> The Azure Event Hubs pub/sub and input binding components advanced (checkpointed) their Event Hubs offsets without regard to whether the application actually handled the event successfully.
> `processEvents()` invoked the application through `handleAsync()`, but the error `handleAsync()` returned was discarded at the call site, leaving `UpdateCheckpoint()` with no condition to check before running.
> Both delivery modes were affected, in different ways:
> - With the default `enableInOrderMessageDelivery: false`, checkpointing happened fire-and-forget, independent of message delivery to the application.
> - With `enableInOrderMessageDelivery: true`, the component waited for the handler to return before checkpointing, but checkpointed anyway when the handler responded `RETRY`.

### Azure Event Hubs のチェックポイントが処理成功を反映

- 影響対象: イベントまたはバッチを並行処理する Azure Event Hubs pub/sub または入力バインディング

以前は、失敗したイベントやバッチが破棄され、そのオフセットがチェックポイントに記録されることがありました。現在は、成功するかサブスクリプションがキャンセルされるまで、設定されたバックオフに従って失敗を再試行します。パーティションのチェックポイントは、成功したバッチが途切れずに続く範囲の末尾までしか進みません。また、順序が前後する競合を防ぐため、各パーティションへの書き込みは直列化されます。

> - Under concurrent handling, a partition's checkpoint advances only through the newest contiguous run of successful batches, and checkpoint writes for a partition are serialized so they can no longer race each other out of order.

### [表面化しなかった不具合] Azure Event Hubs のチェックポイント記録をキャンセルまたは所有権喪失後に停止

- 影響対象: Azure Event Hubs の pub/sub サブスクリプションと入力バインディング

以前は、`RETRY` を返したイベントや、サイドカーのクラッシュ時またはパーティションの所有権喪失時に処理中だったイベントがチェックポイントに記録され、再配信されないことがありました。エラーも通知されないまま、配信方式が少なくとも1回から最大1回へと変わる可能性がありました。キャンセルが発生した場合、またはパーティションの所有権喪失が検知された場合は、チェックポイントの記録がスキップされるようになりました。

> - Checkpointing is skipped once the subscription is cancelled or partition ownership loss is observed, and a checkpoint-store failure now surfaces as an error instead of being silently swallowed.

### パーティション単位で直列化される Azure Event Hubs のチェックポイント書き込み

- 影響対象: Azure Event Hubs の pub/sub または入力バインディング

同時処理時、同じパーティションへのチェックポイント書き込みが競合し、順序が前後することがありました。チェックポイントは、成功したバッチの最新の連続区間までのみ進むようになりました。

> - Under concurrent handling, a partition's checkpoint advances only through the newest contiguous run of successful batches, and checkpoint writes for a partition are serialized so they can no longer race each other out of order.

### Azure Event Hubs のチェックポイントストア障害をエラーとして報告

- 影響対象: Azure Event Hubs の pub/sub コンポーネントと入力バインディングコンポーネント

どちらかのコンポーネントでチェックポイントの保存に失敗した場合、以前はその失敗が握りつぶされていました。

> - Checkpointing is skipped once the subscription is cancelled or partition ownership loss is observed, and a checkpoint-store failure now surfaces as an error instead of being silently swallowed.

## 機能・改善 (1)

- Azure Event Hubs のチェックポイント頻度の設定

## その他の変更 (1)

- チェックポイントがない場合の Azure Event Hubs コンシューマーの最古の保持イベントからの開始

---

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