Flutter IoT Riverpod offline queue - MQTT 끊김 중 명령을 안전하게 보관하기

Flutter IoT Riverpod offline queue

이 그림에서는 네트워크가 끊긴 동안에도 앱 안의 사용자 의도는 사라지지 않아야 한다는 점을 봐야 한다.

Flutter IoT 앱에서 MQTT가 끊겼을 때 버튼을 막기만 하면 사용자는 답답하고, 끊긴 상태로 publish를 날리면 명령이 사라진다. 내가 확인한 기준으론 Riverpod 화면 상태와 오프라인 명령 큐를 분리하는 편이 가장 덜 흔들렸다. 화면은 마지막 사용자 의도만 보여주고, 실제 전송 대기는 Repository 아래에서 관리한다.

처음엔 isConnected == false면 전원 버튼을 비활성화했다. 안전해 보였지만 LTE가 잠깐 흔들리는 지하 주차장에서 문제가 생겼다. 사용자는 보일러를 끄고 싶은데 앱은 3초 동안 아무것도 못 하게 했다. 반대로 버튼을 열어두면 재연결 직후 같은 명령이 두 번 전송됐다.

상황 화면 처리 큐 처리
MQTT 연결됨 즉시 전송 결과 표시 큐 비움
연결 끊김 대기 중 표시 명령 1개 저장
같은 기기 연속 탭 마지막 의도만 표시 이전 명령 교체
재연결 성공 동기화 중 표시 순서대로 flush

핵심은 큐를 Widget에 두지 않는 것이다.

class PendingCommand {
  const PendingCommand({
    required this.deviceId,
    required this.topic,
    required this.payload,
    required this.createdAt,
  });

  final String deviceId;
  final String topic;
  final String payload;
  final DateTime createdAt;
}

기기별 마지막 명령만 남기면 보일러 전원을 켰다가 바로 끄는 상황에서도 오래된 명령이 뒤늦게 나가지 않는다.

class MqttCommandQueue {
  final _items = <String, PendingCommand>{};

  void enqueue(PendingCommand command) {
    _items[command.deviceId] = command;
  }

  List<PendingCommand> drain() {
    final values = _items.values.toList()
      ..sort((a, b) => a.createdAt.compareTo(b.createdAt));
    _items.clear();
    return values;
  }
}

Riverpod에서는 큐 상태를 화면에서 직접 고치지 않고, 연결 상태 변화에 맞춰 flush만 호출했다.

ref.listen(mqttSessionProvider, (previous, next) {
  if (previous?.connected == false && next.connected) {
    ref.read(commandRepositoryProvider).flushPendingCommands();
  }
});

여기서 헷갈렸던 건 모든 명령을 보관해야 한다는 생각이었다. 온도 22도, 23도, 24도를 1초 안에 누른 경우라면 세 개를 모두 보낼 필요가 없다. 마지막 값 24도만 의미가 있다. 반대로 문 열림 알림처럼 사건 로그는 덮어쓰면 안 된다. 명령인지 이벤트인지 기준을 나눠야 한다.

주의할 점은 큐 보관 시간이다. 10분 전에 눌렀던 보일러 켜기 명령이 재연결 후 갑자기 실행되면 더 위험하다. 나는 제어 명령은 30초, 화면 새로고침은 10초처럼 짧게 잡고 시간이 지난 명령은 버리는 쪽이 낫다고 봤다.

짧게 정리하면 이렇다.