技術コラムCOLUMN

通信が切れても登録をやり直せる設計:再試行で同じ操作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