業務システムのデータを、画面の JavaScript から別のシステムへ送る構成では、タブを閉じられたりネットワークが切れたりして、送りそこねや2 重登録が起こります(理由は ブラウザは「確実な配達係」ではない にまとめています)。この記事では、その対策を整理します。
対策の柱は、送信待ちテーブルと冪等性の 2 つです。
送信待ちテーブル
いちばん大事なのは、「送らなければいけないもの」を、データの保存と同じトランザクションで記録しておくことです。
-- データの保存と「未送信」の記録を、同じトランザクションで行う
BEGIN;
INSERT INTO orders (order_no, ...) VALUES ('A-1001', ...);
INSERT INTO outbox (event_id, order_no, payload, status, created_at)
VALUES ('A-1001-1', 'A-1001', '{...}', 'PENDING', now());
COMMIT;
同じトランザクションにするのは、「データは保存されたのに、未送信の記録がない」(または、その逆)という状態を作らないためです。こうしておけば、送りそこねたものが、必ずテーブルに残ります。
この考え方は、一般に「トランザクショナルアウトボックス」というパターンとして知られています。
送信済みの報告と、自動再送
① 業務システム:保存と同時に「未送信」を記録 → 送信用のデータを画面に返す ② JS:中継 API に送る ③ 中継 API:連携先に登録 → JS に成功を返す ④ JS:業務システムに「この ID は送信済み」と伝える ⑤ 業務システム:記録を「送信済み」に変える
どこで途切れても、記録は「未送信」のまま残ります。そこで、誰かが画面を開いたときに、JS が「未送信」の一覧を業務システムから取得して、自動で送り直します。
ただし、②〜③ は成功したのに ④ の前にタブが閉じられると、記録は「未送信」のままなので、もう一度送られます。これを問題にしないのが、次の冪等性です。
冪等性(同じものが 2 回届いても大丈夫にする)
「冪等(べきとう)」は、同じ操作を何回やっても、結果が 1 回やったときと同じになることです。
- 送るデータに、一意の ID(上の例では
A-1001-1:伝票番号 + 更新回数)を必ず付ける - 中継 API(または連携先の API)は、すでに処理した ID が来たら、登録せずに「成功」を返す
「更新回数」を入れるのは、同じ伝票を後で更新したときに、更新した内容は別のものとして送れるようにするためです。
「すでに処理したか」の確認は、ID に一意制約を付けて、登録と同時に判定するのが確実です。「先に検索して、なければ登録」という作りだと、同じ ID がほぼ同時に 2 つ届いたときに、どちらも「まだない」と判断して 2 件登録されることがあります。
-- 中継 API が処理済みの ID を記録するテーブル(event_id に一意制約)
INSERT INTO processed_events (event_id, processed_at)
VALUES ('A-1001-1', now());
-- 一意制約の違反になったら「処理済み」とみなして、成功を返す
ここまでできれば、再送は「迷ったら送り直す」という単純な作りにできます。複数の利用者のブラウザが、同じ「未送信」のデータを同時に送り直しても問題ありません。
未送信の監視と、手動の再送画面
自動再送は、誰かが画面を開かないと動きません。夜間や休日など、誰も画面を開かない時間が続くと、「未送信」が残ったままになります。
- 「未送信」が一定時間(例:10 分)以上残っていたら、画面に警告を出す、担当者に知らせる
- 連携先がずっとエラーを返すような場合に備えて、人が確認して送り直せる画面を用意する
まとめ
| 対策 | 役割 |
|---|---|
| 送信待ちテーブル | 送るべきものを、保存と同じトランザクションで必ず記録する |
| 送信済みの報告・自動再送 | 送りそこねたものを、画面を開いたときに送り直す |
| 冪等性 | 送り直しても 2 重登録にならないようにする(一意制約で判定) |
| 未送信の監視・手動の再送画面 | 自動再送で拾えないものに気づき、人が対応する |
それでも、ブラウザが配達係である限り、送られるタイミングは利用者しだいです。構成を変えられるなら、ブラウザに配達させない:中継 API に取りに来てもらう方式 も検討してください。