通信が切れても登録をやり直せる設計:再試行で同じ操作IDを使う
- Mobile Development
- 2026.11.16
登録ボタンを押した直後に通信が切れても、登録に失敗したとは限りません。サーバーで処理が完了し、応答だけが届かなかった可能性があるからです。SessionFlowの登録処理を例に、操作IDを使って二重登録を防ぐ設計を紹介します。
操作IDと入力内容を送信前に保存する
SessionFlowでは、新規登録に操作IDを割り当て、入力内容と一緒に端末へ保存してから送信します。保存に失敗した場合は送信しません。先に送ってしまうと、応答を受け取る前にアプリが終了したとき、同じ操作IDで再開できないためです。
Swiftの実装例:保存済みの操作IDで送信する
次はSessionFlowの登録処理から、送信部分だけを抜粋したコードです(コメントは省略)。初回も再試行も、保存済みの draft から登録内容と操作IDを渡します。
let created: CreatedOrganization
switch await repository.create(name: draft.name, operationId: draft.operationId) {
case let .success(result):
created = result
case .failure:
return .failure(.requestFailed)
}リクエストが失敗した場合は、元の操作IDと入力内容を残します。再試行で入力が変わっていたら、同じ操作IDのまま別の内容は送信しません。登録済みの結果が端末に残っている場合は、再登録せずにサーバーの状態を確認します。
二重登録を防ぐにはサーバー側の協力も必要
操作IDは、同じ登録を再送していることを伝える目印です。二重登録を防ぐには、サーバーが同じ操作IDと内容の再送を既存の操作として扱い、処理済みならその結果を返す必要があります。このように、繰り返しても意図した効果が増えない性質を冪等性(べきとうせい)と呼びます。RFC 9110 §9.2.2では、HTTPメソッドの冪等性と再試行の関係が説明されています。
テストでは「応答が届かなかった」を再現する
SessionFlowのテストでは、結果が不明なときに同じ入力と操作IDを再送すること、入力が変わったら送らないこと、端末への保存に失敗したら通信を始めないことを確認しています。予約や申請でも、画面上のエラー表示とあわせて、何を保存し、いつ再送し、どこで結果を確定するかを決めておくと、利用者が途中から作業を再開できます。
送信中やエラー時の画面表示については、SwiftUIとJetpack Composeで考える、使いやすい業務アプリの設計もご覧ください。
この記事を書いた人
Kaoru Miyamoto
人気の記事
Development Tools
2026.03.26
【お知らせ】弊社エンジニアの開発環境・愛用ガジェット紹介記事を公開しました
こんにちは。株式会社Apps 宮本です。日々のスマートフォン…
Architecture & Design
2026.10.13
SwiftUIとJetpack Composeで考える、使いやすい業務アプリの設計
業務アプリの使いやすさは、見た目だけでは決まりません。入力・通信・エラー・再操作をどう扱うか。Swi
iOS Development
2026.10.19
SwiftUIの検索APIで古い結果を表示しないために:.task(id:)とSwift Concurrencyのキャンセル設計
SwiftUIの検索APIで古い結果の上書きを防ぐ実装。.task(id:)、Task.checkC
