Flutter GetX Controller 테스트 - 비동기 다이얼로그 처리하는 법

코드 테스트

이전 편에서 Fake Repository를 만들고 Controller 기본 테스트를 잡았다. 거기서 끝에 예고한 대로, MemberManagementController를 테스트하다가 막혔다. 멤버 삭제 버튼 → 확인 다이얼로그 → “확인” 탭 → API 호출. 이 흐름을 Unit Test에서 어떻게 재현하나.

Get.defaultDialog를 테스트에서 쓸 수 없다

처음 Controller 코드는 이랬다.

Future<void> removeMember(String memberId) async {
  Get.defaultDialog(
    title: '멤버 삭제',
    middleText: '정말 삭제하시겠습니까?',
    onConfirm: () async {
      Get.back();
      await _repository.removeMember(memberId: memberId);
    },
  );
}

flutter test로 돌리면 바로 터진다. GetMaterialApp 없이 Get.defaultDialog를 호출하면 위젯 트리가 없다는 오류다. Widget Test로 환경을 만들면 Get.put() 초기화가 꼬이고, pumpWidget에 GetMaterialApp을 넣으면 또 다른 문제가 생겼다.

두 시간 삽질하고 나서 결론이 나왔다. “Controller가 다이얼로그를 직접 띄우면 안 된다.”

콜백 주입 패턴

“사용자가 확인했는지 물어보는 동작”을 Future<bool> Function() 타입으로 외부에서 주입받는다.

class MemberManagementController extends GetxController {
  MemberManagementController({
    required MemberRepository repository,
    Future<bool> Function()? confirmRemove,
  })  : _repository = repository,
        _confirmRemove = confirmRemove ??
            (() async {
              final result = await Get.defaultDialog<bool>(
                title: '멤버 삭제',
                middleText: '이 멤버를 공간에서 삭제합니다.',
                onConfirm: () => Get.back(result: true),
                onCancel: () => Get.back(result: false),
              );
              return result ?? false;
            });

  final MemberRepository _repository;
  final Future<bool> Function() _confirmRemove;
  final isLoading = false.obs;
  final members = <Member>[].obs;

  Future<void> removeMember(String memberId) async {
    final confirmed = await _confirmRemove();
    if (!confirmed) return;

    isLoading.value = true;
    final result = await _repository.removeMember(memberId: memberId);
    isLoading.value = false;

    result.fold(
      onSuccess: (_) => members.removeWhere((m) => m.id == memberId),
      onFailure: (msg) => Get.snackbar('오류', msg),
    );
  }
}

기본값이 실제 다이얼로그를 띄우는 함수라서, 앱 코드에서 MemberManagementController(repository: repo)처럼 그냥 쓰면 된다. 프로덕션 동작은 그대로다.

Controller 테스트

void main() {
  late FakeMemberRepository fakeRepo;
  late MemberManagementController controller;

  void setup({bool userConfirms = true}) {
    fakeRepo = FakeMemberRepository();
    Get.put<MemberRepository>(fakeRepo);
    controller = Get.put(
      MemberManagementController(
        repository: fakeRepo,
        confirmRemove: () async => userConfirms,
      ),
    );
  }

  tearDown(Get.reset);

  group('removeMember', () {
    test('취소하면 Repository를 호출하지 않는다', () async {
      setup(userConfirms: false);
      fakeRepo.setMembers([Member(id: 'm1', name: '홍길동')]);

      await controller.removeMember('m1');

      expect(fakeRepo.removeCallCount, 0);
      expect(controller.members.length, 1);
    });

    test('확인하면 멤버가 목록에서 제거된다', () async {
      setup(userConfirms: true);
      fakeRepo.setMembers([Member(id: 'm1', name: '홍길동')]);
      controller.members.assignAll(fakeRepo.members);

      await controller.removeMember('m1');

      expect(fakeRepo.removeCallCount, 1);
      expect(controller.members, isEmpty);
    });

    test('서버 오류 시 members 목록이 유지된다', () async {
      setup(userConfirms: true);
      fakeRepo.setMembers([Member(id: 'm1', name: '홍길동')]);
      fakeRepo.shouldFail = true;
      controller.members.assignAll(fakeRepo.members);

      await controller.removeMember('m1');

      expect(controller.members.length, 1);
    });
  });
}

setup() 헬퍼에 userConfirms 파라미터 하나로 “사용자가 확인했다/취소했다” 시나리오가 명확하게 표현된다. 테스트 읽는 사람이 다이얼로그 동작을 추론할 필요가 없다.

Fake Repository에 호출 카운터 추가

Mockito 없이 Fake 구현체에 removeCallCount 필드를 직접 달았다. 이 정도 검증 수준에서 Mockito를 끌어오는 건 오버킬이었다.

class FakeMemberRepository implements MemberRepository {
  final List<Member> _members = [];
  int removeCallCount = 0;
  bool shouldFail = false;

  void setMembers(List<Member> members) {
    _members
      ..clear()
      ..addAll(members);
  }

  List<Member> get members => List.from(_members);

  @override
  Future<Result<void>> removeMember({required String memberId}) async {
    removeCallCount++;
    if (shouldFail) return Result.failure('서버 오류');
    _members.removeWhere((m) => m.id == memberId);
    return Result.success(null);
  }
}

처음에 Completer로 시도했다가 포기한 이유

콜백 주입 전에 Completer<bool>을 Controller 안에 두고 테스트에서 외부에서 complete(true)를 호출하는 방식을 시도했다. await controller.removeMember()가 Completer를 기다리는 동안 테스트 코드가 멈추니까, completer를 먼저 complete하고 나서 await를 걸어야 했다. 순서가 보장이 안 됐다. 비동기 타이밍 맞추다가 테스트가 flaky해지는 전형적인 패턴이었다.

콜백 주입은 Controller 입장에서 “확인 함수를 호출하고 결과를 기다린다”는 인터페이스가 동일하면서, 테스트에서는 그냥 () async => true를 넘기면 끝난다.


다음 편은 flutter_blue_plus BLE 관련 테스트다. FlutterBluePlus 클래스가 static 메서드 위주라서 의존성 격리를 다른 방식으로 해야 한다.