はじめに AIコーディングアシスタントと開発していて、ある落とし穴に気づいた。 エラーが発生したとき、AIはエラーを「抑え込んで」処理を継続させる方向で対応する。 その対応に「冪等性の確保」という名前がつくと、正しい設計判断に見えてしまう。しかし実際には、真の問題を隠蔽していただけだった。 この記事では、Flutter アプリ開発で実際に体験した「冪等性の罠」を通じて、エラー対応の本質について考える。 冪等性とは 冪等性（idempotency）とは、ある操作を何度実行しても1回実行したときと同じ結果になる性質。 APIでいえば、同じリクエストを2回送っても1回送ったときと同じ結果になること。データベースでいえば、同じINSERTを2回実行しても重複レコードが作られないこと。 冪等性は分散システムやネットワーク通信において非常に重要な概念であり、リトライ処理やイベント駆動アーキテクチャの信