システム設計

ブラウザは「確実な配達係」ではない:JS でデータを連携するときの取りこぼし

業務システムで登録したデータを、別のシステムの API に「リアルタイムで伝えたい」という場面があります。普通はサーバー同士で送りますが、事情によってサーバーからは外へ通信できず、画面の JavaScript から送るしかない、ということがあります。この記事では、そのときに何が起こりうるのかを整理します。

想定する構成

業務システム のサーバー 外へ通信できない 利用者の PC の ブラウザ(JS) 中継 API 外へ通信できる サーバー 連携先の API ①②③ ↑ ここが配達係 ① 業務システムがデータを保存し、送信用のデータを画面に返す ② ブラウザ(JS)が、送信用のデータを中継 API に送る ③ 中継 API が、連携先の API に登録する

ポイントは、② をブラウザが担当していることです。ブラウザが配達係になっています。

起こりうること

サーバー同士の通信なら、失敗してもサーバーが後で送り直せます。ところがブラウザは、利用者がいつでも閉じられるし、ネットワークも安定しているとは限りません。

起こること結果
保存した直後に、タブを閉じる・画面を移動する送られない
PC のネットワークが一瞬切れる送られない
送れたのに、返事が来る前にタブを閉じる送れたかどうか分からない
中継 API や連携先の API が一時的にエラー送られない(ブラウザ側で再送しない限り)

しかも、この構成のサーバーは自分から通信できないので、サーバー側で後から再送することができません。放っておくと、業務システムと連携先のデータが、気づかないうちに食い違っていきます。

いちばんやっかいなのは「届いたか分からない」

ブラウザから見た状況は、3 つに分かれます。

ブラウザから見た状況実際
成功の返事が来た届いている
エラーの返事が来た届いていない(ことが多い)
返事が来ない・途中でタブが閉じられた届いたかもしれないし、届いていないかもしれない

3 つめでは、「届いていない」と思って送り直すと 2 重登録になり、「届いた」と思って何もしないと取りこぼしになります。どちらに倒しても困る、というのがこの構成の難しいところです。

fetch の keepalive だけでは防げない

ページを離れる直前に送る場合は、fetch に keepalive: true を付けると、ページを離れた後も送信が続きやすくなります。

fetch("https://relay.example.com/orders", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(data),
  keepalive: true   // ページを離れても、送信を続けるようにブラウザに頼む
});

ただし、送れるのは送信中のものを合わせて 64KB までで、ページを離れた後は成功したかどうかを JS で受け取れません。ネットワークが切れた場合にも役に立ちません。送りそこねを減らす工夫にはなりますが、なくすことはできません。

では、どうするか

対策の柱は 2 つです。

  • 送信待ちテーブル:送るべきものを、データの保存と同じトランザクションで記録しておき、送りそこねたら送り直す
  • 冪等性:同じものが 2 回届いても、1 回分しか登録されないようにする

この 2 つがあれば、「迷ったら送り直す」という単純な作りにできます。詳しくは 送りそこねと 2 重登録を防ぐ:送信待ちテーブルと冪等性 にまとめています。

また、構成を変えられるなら、そもそもブラウザに配達させない方法もあります。ブラウザに配達させない:中継 API に取りに来てもらう方式 を見てください。

まとめ

  • ブラウザはいつでも閉じられ、ネットワークも不安定なので、確実な配達係ではない。
  • 特にやっかいなのは、届いたかどうか分からない場合。送り直すと 2 重登録、送り直さないと取りこぼしになる。
  • keepalive は補助にすぎない。送り直せる仕組みと、送り直しても大丈夫な仕組みが必要になる。
スポンサーリンク
タイトルとURLをコピーしました