6  落とし穴 3:部分更新・取りこぼし・二重実行

無限ループほど派手ではありませんが、気づきにくい不具合が 3 つあります。

6.1 部分更新:温度だけ変えたら電源が切れる

エアコンが「ON・冷房・24℃」のときに、「アレクサ、エアコンを 26 度にして」と言うと、Lambda は desired に {"temp": 26, "cmdId": ...} を書きます。 delta には、変わったフィールドだけ が入ります(実測)。

desired を更新: {"temp": 26}
delta: {"temp": 26}

ここで、デバイスが delta を「エアコンの全設定」だと思って、

power = delta.get("power", False)    # 入っていない → False
temp  = delta.get("temp", 26)
send_aircon(power, temp)             # 電源 OFF の信号を送ってしまう

と書くと、温度を変えただけなのに電源が切れます。入っていないフィールドを、既定値で埋めてしまったためです。

正しくは、今の状態を元に、届いたフィールドだけを上書き します(virtual_device.py)。

for k in AC_KEYS:          # 届いたフィールドだけ上書きし、残りは現在値のまま
    if k in delta:
        ac[k] = delta[k]
ヒント「今の状態」をどこに持つか

デバイスが再起動しても今の状態が分かるように、元のプロジェクトでは ESP32 のフラッシュ(NVS)に保存しています。 赤外線の家電は状態を返してくれないので、デバイスが覚えている状態が唯一の手がかり です。

6.2 取りこぼし:切断中の delta は届かない

デバイスが Wi-Fi の切断や再起動で オフラインのあいだに配信された delta は、再接続しても届きません(実測)。

# デバイスを止めた状態で
python device/send.py slot 1
python device/send.py ac --power on --temp 23
# デバイスを起動する
python device/virtual_device.py
[   0.1s] 接続しました(Success)
[   0.1s]   <<< reported 更新: {"power": false, "mode": "cool", "temp": 26, "fan": "auto"}
[   0.2s] delta 受信(get): {"sendSlot": "1-1791382699754", "power": true, "temp": 23, "cmdId": "1791382700002"}
[   0.2s]   >>> 赤外線送信 #1: スロット 1「テレビ 音量+」
[   0.2s]   >>> 赤外線送信 #2: エアコン {'power': True, 'mode': 'cool', 'temp': 23, 'fan': 'auto'}

仮想デバイスは、接続直後に get を送って、そのときの delta をまとめて受け取っている ので、切断中の 2 つの操作をどちらも実行できました。 購読しただけで get をしないと、この 2 つは失われます。

ノートMQTT の永続セッションなら届く

接続時に clean session = false(永続セッション)を指定し、QoS 1 で購読していれば、切断中の delta は AWS IoT が保持し、同じクライアント ID で再接続したときに届きます(実測)。 ただし、保持される期間には上限があり(既定 1 時間)、ESP32 でよく使う PubSubClient の既定は clean session です。 接続直後の get は、セッションの設定に関係なく確実に今の delta を取れるので、両方を使うのが安全です。

6.2.1 push の取りこぼしと、定期的な get

元のプロジェクトでは、接続中でも push された delta が ESP32 に届かないことがありました(WiFiClientSecure と PubSubClient の組み合わせで、TLS のデータが分割されて届いたときに受信を取りこぼす現象)。 そこで、5 秒ごとに get を送るポーリング を、push の予備として常に動かしています(virtual_device.py の --poll)。

6.3 二重実行:同じ delta が 2 回届く

push と get の両方で delta を受け取る設計にすると、同じ delta が 2 回届く ことがあります。上の再接続の実験の続きを見てください。

[   0.2s]   <<< reported 更新: {"power": true, "mode": "cool", "temp": 23, "fan": "auto", "cmdId": "1791382700002"}
[   0.3s] delta 受信(push): {"power": true, "temp": 23, "cmdId": "1791382700002"}
[   0.3s]   (cmdId 1791382700002 は処理済みなので送信しない)

get で処理したのと 同じエアコンのコマンドが、0.1 秒後に push でも届いています。 原因は、接続直後の 状態の報告(0.1 秒)です。この時点ではまだ desired と食い違っていたので、その報告をきっかけに delta が配信されました(第 1 章の規則 5)。

重複チェックがなければ、エアコンに同じ信号を 2 回送ります。エアコンなら実害は小さいですが、トグル式の照明なら点いてすぐ消えます。

6.3.1 対策:処理済みのコマンドを覚える(冪等にする)

コマンドには毎回違う値("5-時刻"、cmdId)が付いているので、処理済みの値を覚えておけば、2 回目は実行せずに済みます。

if raw in done_ids:
    log("処理済みなので送信しない")
else:
    send_ir(...)
    done_ids.add(raw)
report({"sendSlot": raw})     # 書き戻しは毎回する(delta を消すため)

同じ操作を何回受け取っても結果が 1 回分になる性質を 冪等(べきとう) といいます。 ネットワーク越しの命令は「少なくとも 1 回 届く(2 回以上届くこともある)」と考え、受け取る側を冪等にしておくのが基本です。

ヒント処理済みの記録はどれくらい残すか

仮想デバイスは処理済みの値をすべて覚えていますが、マイコンではメモリが限られます。 「最後に処理した sendSlot の値」と「最後に処理した cmdId」の 2 つを覚えるだけでも、ここで見た二重実行は防げます。

6.4 シミュレータで確かめる

「デバイスの実装」を 重複チェックなし にして、次を試してください。

  1. 「デバイスを切断」する
  2. 「エアコン ON 24℃」を押す(切断中なので届かない)
  3. 「デバイスを接続」する → 接続直後の get と、状態報告をきっかけにした push の 両方 で届き、送信が 2 回になる

正しい実装 に戻して同じことをすると、2 回目は「処理済み」として送信しません。

重要この章のまとめ
  • delta には 変わったフィールドだけ が入る。今の状態に上書き し、既定値で埋めない
  • 切断中の delta は届かない。接続直後に get する(永続セッションも併用できる)
  • 同じ delta が 2 回届くことがある。処理済みの値を覚えて 冪等 にする