· Flutter 개발 · 6 min read

Flutter WidgetTester ScaffoldMessenger 테스트 - MQTT 명령 SnackBar 중복 방지

Flutter WidgetTester에서 ScaffoldMessenger로 표시하는 MQTT 명령 성공·실패 SnackBar를 검증하고, pump 타이밍과 중복 알림 문제를 해결하는 방법을 정리했다.

Flutter WidgetTester ScaffoldMessenger로 MQTT 명령 결과를 테스트하는 화면

이 그림에서 볼 부분은 기기 명령 자체가 아니라, 명령 결과를 사용자에게 한 번만 알리는 피드백 영역이다.

Flutter IoT 화면에서 SnackBar를 확인할 때 find.text()만 호출하면 충분하다고 생각하기 쉽다. 실제로는 ScaffoldMessenger가 올라오기 전이거나, pump()를 호출하지 않아 테스트 트리에 메시지가 아직 없거나, 같은 MQTT 이벤트가 두 번 들어와도 테스트가 통과하는 문제가 생긴다. ScaffoldMessenger를 테스트 화면에 명시하고, 이벤트와 프레임 진행을 나눠야 성공·실패 피드백을 안정적으로 검증할 수 있다.

화면 안에 ScaffoldMessenger를 직접 둔다

아래 위젯은 MQTT 서비스의 결과를 받은 뒤 한 번만 SnackBar를 띄우는 최소 예다. 실제 프로젝트에서는 Controller가 CommandResult를 발행하고 화면이 그 결과를 구독하는 구조를 사용했다.

class CommandResultView extends StatelessWidget {
  const CommandResultView({super.key, required this.result});

  final CommandResult? result;

  void _showResult(BuildContext context) {
    final current = result;
    if (current == null) return;

    final messenger = ScaffoldMessenger.of(context);
    messenger
      ..hideCurrentSnackBar()
      ..showSnackBar(
        SnackBar(
          content: Text(
            current.isSuccess ? '보일러 명령이 적용됐습니다' : '명령 적용에 실패했습니다',
          ),
        ),
      );
  }

  @override
  Widget build(BuildContext context) {
    WidgetsBinding.instance.addPostFrameCallback((_) {
      _showResult(context);
    });

    return const Text('보일러 제어');
  }
}

build()에서 부수효과를 직접 실행하면 rebuild마다 SnackBar가 다시 생길 수 있다. 위 코드는 설명을 위한 축약 예시고, 실제 구현에서는 Controller의 결과를 StatefulWidget의 didUpdateWidget이나 Riverpod ref.listen처럼 한 번만 실행되는 경계에서 처리해야 한다. 핵심은 hideCurrentSnackBar()로 이전 메시지를 정리하고, 화면에는 현재 결과만 남기는 것이다.

WidgetTester에서는 pump 순서를 분리한다

테스트에서 필요한 건 “버튼을 눌렀다”와 “MQTT ACK를 받았다” 사이의 시간 제어다. Fake 서비스가 결과를 반환한 뒤 한 프레임을 진행하고 SnackBar를 찾는다.

testWidgets('MQTT 명령 성공 결과를 SnackBar로 한 번 알린다', (tester) async {
  final fakeService = FakeMqttService(
    result: const CommandResult.success(),
  );

  await tester.pumpWidget(
    MaterialApp(
      home: Scaffold(
        body: CommandPage(service: fakeService),
      ),
    ),
  );

  await tester.tap(find.text('보일러 켜기'));
  await tester.pump(); // 명령 발행과 ACK 처리

  expect(find.text('보일러 명령이 적용됐습니다'), findsOneWidget);
  expect(find.byType(SnackBar), findsOneWidget);

  await tester.pump(const Duration(seconds: 4));
  expect(find.byType(SnackBar), findsNothing);
});

tap() 뒤에 바로 expect()를 쓰면 안 된다. 탭 콜백에서 await service.publish()가 실행되고, 완료 후 상태가 바뀌기 때문이다. 반대로 pumpAndSettle()만 쓰면 SnackBar의 표시 시간까지 모두 기다리므로 테스트가 느려지고, MQTT 상태 스트림이 계속 살아 있을 때는 끝나지 않는다.

상황테스트 호출확인할 것
명령 버튼 탭tap() 후 pump()ACK 전송 로직 실행
성공·실패 메시지 표시find.text()올바른 문구 1개
연속 이벤트pump() 후 개수 확인SnackBar 중복 여부
표시 시간 종료pump(Duration)화면에서 제거되는지

중복 이벤트 테스트를 따로 둔다

스마트홈에서는 같은 ACK가 재전송될 수 있다. 처음에는 성공 메시지가 보이는지만 검사했는데, MQTT reconnect 뒤 같은 commandId의 ACK가 두 번 들어오자 SnackBar도 두 개가 쌓였다. 테스트에 중복 이벤트를 넣고 기존 메시지를 교체하는지 확인해야 한다.

testWidgets('같은 MQTT commandId의 ACK는 SnackBar를 중복 표시하지 않는다',
    (tester) async {
  final controller = FakeCommandController();

  await tester.pumpWidget(
    MaterialApp(
      home: Scaffold(
        body: CommandPage(controller: controller),
      ),
    ),
  );

  controller.emit(const CommandResult.success(commandId: 'cmd-7'));
  await tester.pump();
  controller.emit(const CommandResult.success(commandId: 'cmd-7'));
  await tester.pump();

  expect(find.byType(SnackBar), findsOneWidget);
});

실제 Controller에는 마지막으로 처리한 commandId를 저장하고 같은 값이면 UI 이벤트를 건너뛰는 조건을 넣었다. 모든 성공 결과를 막으면 다른 명령의 피드백까지 사라지므로, 단순히 “최근 결과가 성공이면 무시”하는 식으로 구현하면 안 된다.

솔직하게 정리하면, Flutter WidgetTester에서 SnackBar 테스트의 핵심은 메시지 문자열보다 이벤트 수명이다. ScaffoldMessenger가 있는 테스트 환경을 만들고, tap → pump → 결과 확인 순서를 고정하고, MQTT ACK의 commandId 중복까지 검증해야 실제 앱의 알림 중복을 잡을 수 있다.

Share:
Back to Blog