Flutter integration_test 데이터 초기화 - IoT 앱의 순서 의존성 끊기

Flutter integration_test 데이터 초기화와 실제 기기 테스트

이 그림에서 봐야 할 부분은 같은 앱이라도 실행 전 상태가 다르면 테스트 결과가 달라진다는 점이다.

Flutter integration_test가 혼자 실행할 때는 통과하는데 전체 파일을 돌리면 실패한다면, 테스트 코드보다 데이터 초기화를 먼저 의심하는 편이 빠르다. IoT 앱에서는 로그인 토큰, 선택된 공간, Realm 데이터, Riverpod Provider 상태가 한 번 남으면 보일러 제어 시나리오가 앞 테스트의 결과를 이어받는다. 나도 Firebase Test Lab에 올린 뒤에야 이 문제가 기기별 차이가 아니라 순서 의존성이라는 걸 확인했다.

setUp만으로 부족했던 이유

setUp은 Dart 테스트 함수가 실행되기 전에 호출된다. 하지만 앱 프로세스가 이미 떠 있고, ProviderContainer나 로컬 DB가 앱 시작 과정에서 만들어졌다면 단순히 변수 몇 개를 비우는 것으로는 부족하다.

남아 있는 상태 실제 증상 초기화 위치
SecureStorage 토큰 로그인 화면이 건너뛰어짐 앱 실행 전
Realm 공간 데이터 이전 공간의 보일러가 표시됨 테스트 시작 전
ProviderContainer MQTT 상태가 connected로 남음 앱 재시작 시
서버 테스트 데이터 삭제 시나리오가 두 번째부터 실패 API fixture

특히 flutter drive처럼 앱을 한 번 띄운 채 여러 시나리오를 실행하면 setUp이 앱을 다시 시작해주지 않는다. 테스트마다 독립된 시작점을 만들려면 초기화 경계를 명확히 정해야 한다.

테스트 모드와 fixture를 분리한다

실제 서버를 매번 지우는 방식은 느리고, Test Lab에서 병렬 실행할 때 서로의 데이터를 건드릴 수 있다. 앱에 테스트 모드를 주입하고, 그 모드에서만 초기화 API와 고정 fixture를 사용했다.

--dart-define으로 테스트 모드를 넣으면 운영 빌드에 테스트용 초기화 코드가 섞이는 위험도 줄어든다.

# integration_test용 APK 실행 시 테스트 모드 주입
flutter test integration_test/smarthome_flow_test.dart \
  --dart-define=APP_ENV=test \
  --dart-define=RESET_FIXTURE=true

앱 시작점에서는 환경값을 읽어 테스트 Repository와 초기화 서비스를 선택한다.

const appEnv = String.fromEnvironment('APP_ENV', defaultValue: 'prod');
const resetFixture = bool.fromEnvironment(
  'RESET_FIXTURE',
  defaultValue: false,
);

Future<void> bootstrap() async {
  final storage = await SecureStorage.create();

  if (appEnv == 'test' && resetFixture) {
    await storage.deleteAll();
    await TestFixture.seedRealm();
  }

  runApp(App(
    overrides: appEnv == 'test' ? testOverrides : const [],
  ));
}

여기서 deleteAll()을 모든 실행에 넣으면 편해 보이지만, 로그인 상태를 유지하는 테스트까지 깨진다. 시나리오의 시작 조건을 freshUser, loggedInUser, occupiedRoom처럼 이름으로 나누고 필요한 fixture만 선택하는 게 낫다.

테스트마다 앱 상태를 다시 만든다

한 파일에서 여러 흐름을 묶어야 한다면 테스트 사이에 앱을 재시작하거나 ProviderContainer를 새로 만들어야 한다. Riverpod을 사용한다면 전역 container를 공유하지 않는 것이 핵심이다.

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  setUp(() async {
    await TestFixture.resetLocalData();
  });

  testWidgets('거실 보일러를 켜면 현재 공간 상태가 갱신된다', (tester) async {
    await app.main(testMode: true);
    await tester.pumpAndSettle(const Duration(seconds: 2));

    await tester.tap(find.byKey(const Key('room-living')));
    await tester.tap(find.byKey(const Key('boiler-on')));

    expect(find.text('켜짐'), findsOneWidget);
  });
}

실제 프로젝트에서는 app.main()을 여러 번 호출하는 것만으로 충분하지 않았다. 네이티브 플러그인과 이미 연결된 MQTT 클라이언트가 살아 있었기 때문이다. 테스트 전용 disconnect()와 ProviderContainer.dispose()를 앱 종료 훅에 넣고, fixture 초기화가 끝난 뒤 새 container를 만들도록 순서를 고정했다.

Firebase Test Lab에서 확인할 기준

Flutter Firebase Test Lab integration_test 실기기 테스트처럼 기기 매트릭스를 넓히기 전에 로컬에서 순서를 섞어 실행한다.

flutter test integration_test --test-randomize-ordering-seed=random

실패가 재현되면 로그에 fixture, roomId, provider disposed를 남긴다. “거실 보일러가 켜지지 않음”만 출력하면 화면 문제처럼 보이지만, 실제로는 침실 fixture가 남아 있던 경우가 있었다.

정리하면 세 가지다.

이렇게 경계를 나누면 integration_test가 느리더라도 실패 원인을 따라갈 수 있다. 테스트가 가끔 통과하는 상태를 성공으로 착각하지 않는 게 가장 중요하다.