Webエンジニア向けプログラミング解説動画をYouTubeで配信中!
▶ チャンネル登録はこちら

【ITニュース解説】A lost response is not a failed write: design retries around intent

2026年11月03日に「Dev.to」が公開したITニュース「A lost response is not a failed write: design retries around intent」について初心者にもわかりやすく解説しています。

作成日: 更新日:

ITニュース概要

通信エラーでレスポンスが届かず、処理が重複してしまう問題を解決する方法だ。クライアントは「べき等キー」を使って操作の意図を固定し、再試行時も同じキーとデータを送る。サーバーはキーで重複リクエストを識別し、確実に一度だけ処理されるよう設計する必要がある。

ITニュース解説

Webサービスを利用していて、ボタンをクリックしたのに画面が固まってしまったり、応答が返ってこなかったりする経験はないだろうか。そのような状況で、もう一度同じボタンをクリックすると、予期せぬ事態が起こることがある。例えば、商品購入ボタンを一度押したが応答がなく、もう一度押したら商品が二重に購入されてしまった、といったケースだ。これは、サーバーは最初のクリックで商品の購入処理を正常に完了していたにもかかわらず、その結果がクライアント(ブラウザなど)に届かなかったために起こる問題である。

具体的には、クライアントがサーバーに何かを作成するようリクエストを送信し、サーバーはそのリクエストを受け取って、データベースへの書き込み処理を成功させたとしよう。サーバーは「成功しました」という応答をクライアントに返そうとするが、ネットワークの問題などで、その応答がクライアントに到達する前に接続が切れてしまうことがある。このとき、クライアントは自分が送ったリクエストが成功したのか、それとも失敗したのかを判断できない状態に陥る。リソース(ここでは商品)が作成されたのかどうかも不明だ。ここで、クライアントが「応答がなかったから失敗したに違いない」と考えて、何の情報もなしに同じリクエストを再送信してしまうと、サーバー側では新しいリクエストとして扱われ、結果として同じ商品が二重に作成されてしまう可能性がある。これは、データの一貫性を損なう重大な問題となる。

このような問題を避けるためには、単にリクエストを再送するのではなく、その操作が「何を意図していたのか」という情報を明確にして、その意図に基づいてリトライを設計する必要がある。つまり、クライアントがある特定の操作を実行しようとしたとき、その操作自体を一つの一意な「意図」として識別し、たとえネットワークの問題で応答が失われたとしても、後続のリトライが常に最初の「意図」と同じ操作であることをサーバーに伝えられるようにするのだ。

この設計の第一歩は、クライアント側で各操作に一意な「操作を識別する鍵」(「冪等性キー」とも呼ばれる)を割り当てることだ。この鍵は、例えばcrypto.randomUUID()のような方法で、ランダムで衝突しない文字列を生成して利用できる。重要なのは、この鍵が特定のボタンやユーザーのセッション全体ではなく、「特定の一つの意図された操作」のみを識別するようにすることである。例えば、「Aという商品をカートに入れる」という操作には常に同じ鍵が割り当てられ、別の操作には別の鍵が割り当てられる。

さらに、この鍵と合わせて、リクエストの「ペイロード」、つまりサーバーに送る具体的なデータ(例: 商品のタイトルや数量)も操作が開始される時点で完全に固定しておく必要がある。一度作成されたこのペイロードは、リトライ時にも変更せずに使い回す。もし、リトライするたびにクライアントのフォームからデータを再構築してしまった場合、最初の処理中にユーザーがフォームの内容を変更してしまうと、リトライ時には異なるデータが送られてしまい、これもまた別の問題を引き起こす可能性があるからだ。

具体的には、クライアント側で「操作を識別する鍵」と、その操作で送信される「固定されたデータ」をひとまとめにした「意図オブジェクト」のようなものを作成する。このオブジェクトは、実際にサーバーにリクエストを送信する機能を持つ。たとえ応答が失われたとしても、この「意図オブジェクト」を再利用してリクエストを再送すれば、サーバーには常に同じ「操作を識別する鍵」と「固定されたデータ」が送られることになる。これにより、クライアントはAPIの応答に基づいて、エラーが発生した場合はユーザーに修正を促し、接続障害のような曖昧な場合は、この固定された「意図」を使ってリトライを試みることができるようになる。

クライアントから「操作を識別する鍵」と固定されたデータを受け取ったサーバーは、その情報をどのように処理すべきだろうか。重要なのは、受け付け処理を「原子的に」(途中で中断されたり、他の処理と競合したりしないように)行うことである。

サーバーはまず、リクエストに含まれるユーザー認証情報を確認し、そのユーザーに操作の権限があるかを検証する。次に、受け取った「操作を識別する鍵」と認証されたユーザーの組み合わせで、既に同様の操作がデータベースに記録されているかを確認する。このとき、以下のいずれかの状況が発生する。

  1. 記録が存在しない場合: その鍵とユーザーの組み合わせでの操作がまだデータベースにない場合、サーバーは新しいリソースを作成し、その操作の完了をデータベースに記録する。この記録には、使用した「操作を識別する鍵」と、受け取ったリクエストのペイロードの「フィンガープリント」(データのハッシュ値など、内容を要約した情報)も一緒に保存する。
  2. 記録が存在し、同じ入力の場合: 同じ鍵とユーザーの組み合わせが既にデータベースにあり、かつ、今回受け取ったリクエストのペイロードが、以前に記録されたフィンガープリントと「同じ内容」(正規化された後で比較されるべき)と判断された場合、サーバーは新しいリソースを作成せず、既に存在するリソースの情報を返す。これは、クライアントがリトライしていることをサーバーが認識し、重複作成を防ぐ最も重要なケースだ。
  3. 記録が存在するが、異なる入力の場合: 同じ鍵とユーザーの組み合わせが既にデータベースにあるが、今回受け取ったリクエストのペイロードが以前の記録と「異なる内容」であった場合、サーバーはこのリクエストを拒否し、衝突エラーとして扱う。なぜなら、同じ「操作を識別する鍵」が二つの異なる意図(異なるデータ)に使用されたと解釈できるためである。

この一連の確認と作成のプロセスは、複数のリクエストが同時にサーバーに到達しても正しく機能するように、排他的に(他の処理と競合しないように)行われる必要がある。例えば、データベースのトランザクション機能や、特定のレコードをロックする仕組みを利用して、レコードの存在チェックと作成が同時に一つの論理的な単位として実行されるように設計する。これにより、二つのリクエストが同時に「記録がない」と判断してそれぞれ新しいリソースを作成しようとする「競合状態」を防ぐことができる。

また、もしサーバーが別の外部サービス(例: 決済サービスや他のAPI)を呼び出す必要がある場合、その外部サービスでの操作は、ローカルのデータベーストランザクションでは取り消せないことに注意が必要だ。もし外部サービスが独自の「操作を識別する鍵」をサポートしていればそれを利用するが、そうでなければ、外部サービスとの連携についても、重複実行を防ぐための調整や、エラー時の復旧手順を別途設計する必要がある。

「操作を識別する鍵」と関連する「意図」をどのくらいの期間保持するかも重要な考慮事項である。もし、クライアントがブラウザを閉じたり再読み込みしたりしても、未解決の操作をリトライできるようにする必要がある場合は、その「意図」の情報をクライアント側(ローカルストレージなど)で永続的に保存しておく必要がある。この情報は、ユーザーがサインインしているアカウントに紐づけられ、セキュリティ上の理由から保護されるべきだ。特に、異なるアカウントに切り替えた後に、以前のアカウントの保留中の操作が誤って再実行されないように注意が必要である。

サーバー側も、過去の「操作を識別する鍵」の記録をいつまで保持するかを明確に文書化すべきだ。クライアントは、サーバーがその記録を保持する期間を超えて非常に古い鍵を安易に再送してはならない。もしサーバーがその古い鍵を新しい操作と誤解した場合、再度重複作成などの問題が発生する可能性がある。そのため、クライアントは、古い鍵を再送する前に、対象のリソースが既に存在しないかを確認するなどの対応が必要になる。

このような複雑なシステムを構築する際には、徹底したテストが不可欠である。具体的には、同じ「操作を識別する鍵」を使ったリクエストが同時に複数送られてきた場合、異なる入力内容で同じ鍵が使われた場合、異なるユーザーが同じ鍵を使おうとした場合、そしてサーバーがコミットを完了した後に接続が失われた場合など、様々なシナリオを想定したテストを行う必要がある。最も重要なのは、これらのテストシナリオのいずれにおいても、最終的にすべての試行が「同じ意図されたリソース」に落ち着くかどうかを確認することだ。

Webサービスにおける「失われたレスポンス」は、単なる失敗とは異なる。それは、サーバーが処理を完了したにもかかわらず、その結果がクライアントに届かなかったという曖昧な状態を示す。このような状況で安易なリトライはデータの重複作成を引き起こすため、操作の「意図」を中心にしたリトライ設計が不可欠となる。クライアントは、操作ごとに一意の鍵と固定されたペイロードで「意図」を定義し、サーバーはその鍵とペイロードを照合して、新規作成、既存の利用、または衝突の判断を原子的に行う。この設計原則は、データの整合性を保ちながら、ユーザー体験を向上させる上で極めて重要である。Teasaのような企業では、ユーザーがストーリーやキャラクターを作成する際に、このような設計を導入することで、安定したサービス提供を実現している。

関連コンテンツ

関連IT用語