業務システムで登録したデータを、別のシステムの API に「リアルタイムで伝えたい」という場面があります。普通はサーバー同士で送りますが、事情によってサーバーからは外へ通信できず、画面の JavaScript から送るしかない、ということがあります。この記事では、そのときに何が起こりうるのかを整理します。
想定する構成
ポイントは、② をブラウザが担当していることです。ブラウザが配達係になっています。
起こりうること
サーバー同士の通信なら、失敗してもサーバーが後で送り直せます。ところがブラウザは、利用者がいつでも閉じられるし、ネットワークも安定しているとは限りません。
| 起こること | 結果 |
|---|---|
| 保存した直後に、タブを閉じる・画面を移動する | 送られない |
| 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は補助にすぎない。送り直せる仕組みと、送り直しても大丈夫な仕組みが必要になる。
