Flutter Riverpod 테스트 전략 — Mocking Providers, Integration Tests, 그리고 CI

Flutter Riverpod 테스트 전략 — Mocking Providers, Integration Tests, 그리고 CI
Riverpod 기반 앱을 올바르게 테스트하는 방법.

ProviderContainer 를 사용한 단위 테스트
// 테스트 대상: 사용자를 가져오는 Provider
final usersProvider = FutureProvider<List<User>>((ref) async {
final repo = ref.watch(userRepositoryProvider);
return repo.getUsers();
});

// 테스트
void main() {
test('usersProvider returns a list of users', () async {
final container = ProviderContainer(
overrides: [
userRepositoryProvider.overrideWithValue(FakeUserRepository()),
],
);
addTearDown(container.dispose);
final users = await container.read(usersProvider.future);
expect(users, hasLength(3));
});
}

class FakeUserRepository implements UserRepository {
@override
Future<List<User>> getUsers() async => [
User(id: '1', name: 'Alice'),
User(id: '2', name: 'Bob'),
User(id: '3', name: 'Charlie'),
];
}

Widget 테스트: ProviderScope 로 Override
testWidgets('UserListPage displays users', (tester) async {
await tester.pumpWidget(
ProviderScope(
overrides: [
userRepositoryProvider.overrideWithValue(FakeUserRepository()),
],
child: const MaterialApp(home: UserListPage()),
),
);

// FutureProvider 가 해결될 때까지 대기
await tester.pumpAndSettle();
expect(find.text('Alice'), findsOneWidget);
expect(find.text('Bob'), findsOneWidget);
});

AsyncNotifier 테스트
final counterProvider = AsyncNotifierProvider<CounterNotifier, int>(CounterNotifier.new,);

class CounterNotifier extends AsyncNotifier<int> {
@override
Future<int> build() async => 0;

Future<void> increment() async {
state = const AsyncLoading();
state = AsyncData((state.value ?? 0) + 1);
}
}

// 테스트
test('CounterNotifier increments', () async {
final container = ProviderContainer();
addTearDown(container.dispose);
await container.read(counterProvider.future);
// build() 완료 대기
await container.read(counterProvider.notifier).increment();
expect(container.read(counterProvider).value, equals(1));
});

CI 통합: GitHub Actions
#.github/workflows/flutter-test.yml

• name: Flutter Test
  run: flutter test --coverage
• name: Upload coverage
  uses: codecov/codecov-action@v3
  with:
  file: coverage/lcov.info

요약
단위 테스트 → ProviderContainer + override
Widget 테스트 → ProviderScope + override
CI → flutter test --coverage + Codecov
핵심 규칙 → 실제 구현체를 FakeXxx 로 대체 (Mockito 불필요)
Riverpod 의 override 메커니즘을 사용하면 Mockito 없이 자체적으로 독립적인 테스트를 작성할 수 있습니다.