Riverpod on jHoon

Ch06. Flutter 네트워킹 - API부터 Riverpod 연동까지 한방 정리

Tue, 05 May 2026 00:00:00 +0900

Ch05에서 상태관리를 끝냈다. ValueNotifier부터 Riverpod까지 같은 Todo 앱을 5번 갈아엎으면서 “뷰와 상태를 어떻게 분리하는가"에 집중했다면, Ch06은 **“그 상태를 서버에서 어떻게 가져오는가”**에 집중한다.

지금까지의 Todo 앱은 로컬 데이터였다. 하지만 실제 앱은 서버에서 데이터를 받아오고, 유저 인증도 하고, 에러도 처리해야 한다. 이번 챕터에서 다루는 전체 파이프라인을 먼저 보면:

1
2


뷰 → ref.watch → Provider → Retrofit → Dio → 인터셉터 → 서버
서버 → JSON → fromJson → Provider 상태 → .when() → 뷰

이걸 하나씩 쌓아 올린다.

1. API 기본 개념

API란?

앱과 서버의 대화 방법이다. 식당으로 치면 메뉴판 — “이 URL로 이런 데이터를 이런 형식으로 보내면, 이런 응답을 줄게"라는 약속.

iOS에서 URLSession으로 직접 요청을 날려본 경험이 있는데, Flutter도 본질은 같다. URL + HTTP 메서드 + 바디 → 서버 → 응답.

REST API

REpresentational State Transfer. URL로 자원을 표현하고, HTTP 메서드로 행위를 구분하는 규칙이다.

1
2
3
4
5


GET /todos → 전체 조회 (Read)
GET /todos/1 → 1번 조회 (Read)
POST /todos → 생성 (Create)
PUT /todos/1 → 수정 (Update)
DELETE /todos/1 → 삭제 (Delete)

“RESTful하다"는 건 이 규칙을 잘 지킨다는 뜻이다. URL에 동사가 들어가거나(/getTodos), 전부 POST로 처리하면 RESTful하지 않다.

HTTP 메서드 = CRUD

HTTP 메서드	CRUD	설명
GET	Read	데이터 조회 (바디 없음)
POST	Create	데이터 생성
PUT	Update	전체 수정
PATCH	Update	부분 수정
DELETE	Delete	삭제

iOS의 URLRequest.httpMethod로 설정하던 것과 동일한 개념.

HTTP 상태 코드

서버의 응답 결과를 세 자리 숫자로 알려준다.

2xx 성공 — 200 OK, 201 Created, 204 No Content
4xx 내 잘못 — 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found
5xx 서버 잘못 — 500 Internal Server Error, 503 Service Unavailable

핵심은 401과 403의 차이. 401은 “너 누구야” (인증 실패), 403은 “너인 건 알겠는데 권한 없어” (인가 실패).

JSON

서버와 주고받는 데이터 형식. XML도 있지만 요즘은 거의 JSON이다.

1
2
3
4
5


{
 "id": 1,
 "title": "Flutter 공부",
 "completed": false
}

Dart에서는 Map<String, dynamic>으로 파싱된다. 이걸 직접 다루면 타입 안전성이 없으니, 뒤에서 Freezed로 모델 클래스를 자동 생성한다.

HTTP vs HTTPS

HTTP에 SSL/TLS 암호화를 얹은 게 HTTPS. 요즘은 HTTPS가 기본이고, iOS의 ATS(App Transport Security)처럼 Flutter도 실무에선 HTTPS만 쓴다.

2. 인증 — 토큰 기반 인증

토큰이란?

로그인 성공 시 서버가 발급하는 증명서. 이후 모든 API 요청에 이 토큰을 함께 보내서 “나 로그인한 사람이야"를 증명한다.

JWT (JSON Web Token) 구조

1
2


xxxxx.yyyyy.zzzzz
헤더 .내용 .서명

헤더: 알고리즘, 토큰 타입
내용 (Payload): 유저 ID, 만료 시간 등 (Base64 디코딩하면 읽을 수 있음 → 민감 정보 넣으면 안 됨)
서명: 서버만 검증 가능한 서명 (위조 방지)

Access Token vs Refresh Token

	Access Token	Refresh Token
수명	짧음 (15분~1시간)	김 (2주~1개월)
용도	API 요청 시 첨부	Access Token 재발급
탈취 시	피해 제한적 (곧 만료)	위험 (새 Access 발급 가능)
저장	메모리 or SharedPreferences	SharedPreferences (암호화)

자동 갱신 흐름

1
2
3
4


1. API 요청 → 401 Unauthorized (Access Token 만료)
2. Refresh Token으로 /auth/refresh 요청
3. 새 Access Token 발급
4. 원래 요청 재시도

이 흐름을 매번 수동으로 하면 미친다. 뒤에서 Dio 인터셉터로 자동화한다.

토큰 저장

1
2
3
4
5
6


// 저장
final prefs = await SharedPreferences.getInstance();
await prefs.setString('accessToken', token);

// 읽기
final token = prefs.getString('accessToken');

SharedPreferences는 iOS의 UserDefaults와 같다. 간단한 키-값 저장. 실무에선 flutter_secure_storage로 암호화 저장을 쓰기도 한다.

Firebase Auth와의 차이

	Firebase Auth	JWT 직접 구현
토큰 관리	SDK가 자동	직접 관리
인터셉터	불필요	필요
유연성	제한적	자유로움
서버	Firebase 종속	자체 서버

Firebase Auth는 토큰 갱신을 SDK가 알아서 해준다. 편하지만 서버 로직을 직접 통제할 수 없다. 자체 서버가 있으면 JWT 직접 관리가 일반적.

3. Dio — HTTP 클라이언트

http vs Dio

Flutter에는 기본 http 패키지가 있다. 하지만 실무에선 거의 Dio를 쓴다.

	http (기본)	Dio
iOS 비유	URLSession	Alamofire
인터셉터	없음	있음
토큰 자동 첨부	직접 구현	인터셉터로 자동
에러 핸들링	기본	풍부
파일 업로드	번거로움	FormData 지원

BaseUrl 설정

1
2
3
4
5
6
7


final dio = Dio(
 BaseOptions(
 baseUrl: 'https://api.example.com',
 connectTimeout: Duration(seconds: 5),
 receiveTimeout: Duration(seconds: 3),
 ),
);

한 번 설정해두면 이후 요청에서 dio.get('/todos')처럼 경로만 쓰면 된다.

인터셉터 — 핵심 기능

인터셉터는 모든 요청/응답을 가로채서 가공하는 미들웨어다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26


class AuthInterceptor extends Interceptor {
 @override
 void onRequest(RequestOptions options, RequestInterceptorHandler handler) {
 // 모든 요청에 토큰 자동 첨부
 final token = TokenStorage.accessToken;
 if (token != null) {
 options.headers['Authorization'] = 'Bearer $token';
 }
 handler.next(options);
 }

 @override
 void onError(DioException err, ErrorInterceptorHandler handler) async {
 if (err.response?.statusCode == 401) {
 // Access Token 만료 → Refresh Token으로 갱신
 final newToken = await refreshToken();
 if (newToken != null) {
 // 토큰 갱신 성공 → 원래 요청 재시도
 err.requestOptions.headers['Authorization'] = 'Bearer $newToken';
 final response = await dio.fetch(err.requestOptions);
 return handler.resolve(response);
 }
 }
 handler.next(err);
 }
}

이걸 Dio에 등록하면:

1

dio.interceptors.add(AuthInterceptor());

이제 모든 API 요청에 토큰이 자동으로 붙고, 401이 오면 자동으로 갱신해서 재시도한다. 인터셉터 없이 이걸 하려면 모든 API 호출마다 토큰 로직을 넣어야 한다.

앱 시작 시 1회 초기화

Dio 인스턴스는 앱 전체에서 하나만 만들어서 공유한다. 보통 DI(의존성 주입) 또는 Provider로 관리.

4. Retrofit — API 코드 자동 생성

Retrofit이란?

Dio 위에 얹는 코드 자동 생성 도구. API 인터페이스만 정의하면 구현체를 build_runner가 만들어준다.

없을 때 vs 있을 때

Dio만 쓸 때 (수동):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


Future<List<Todo>> getTodos() async {
 final response = await dio.get('/todos');
 return (response.data as List)
 .map((json) => Todo.fromJson(json))
 .toList();
}

Future<Todo> createTodo(Todo todo) async {
 final response = await dio.post('/todos', data: todo.toJson());
 return Todo.fromJson(response.data);
}

API가 20개면 이런 코드가 20개. 실수도 잦고 지루하다.

Retrofit 쓸 때 (자동):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


@RestApi(baseUrl: 'https://api.example.com')
abstract class TodoApi {
 factory TodoApi(Dio dio) = _TodoApi;

 @GET('/todos')
 Future<List<Todo>> getTodos();

 @POST('/todos')
 Future<Todo> createTodo(@Body() Todo todo);

 @PUT('/todos/{id}')
 Future<Todo> updateTodo(@Path('id') int id, @Body() Todo todo);

 @DELETE('/todos/{id}')
 Future<void> deleteTodo(@Path('id') int id);
}

선언만 하면 _TodoApi 구현체가 자동 생성된다. HTTP 메서드와 어노테이션이 직관적이라 API 문서를 보면서 그대로 옮기면 된다.

어노테이션 정리

어노테이션	역할	예시
`@RestApi`	기본 URL 설정	`@RestApi(baseUrl: '...')`
`@GET`	GET 요청	`@GET('/todos')`
`@POST`	POST 요청	`@POST('/todos')`
`@PUT`	PUT 요청	`@PUT('/todos/{id}')`
`@DELETE`	DELETE 요청	`@DELETE('/todos/{id}')`
`@Path`	URL 경로 변수	`@Path('id') int id`
`@Body`	요청 바디	`@Body() Todo todo`
`@Query`	쿼리 파라미터	`@Query('page') int page`
`@Header`	헤더	`@Header('Authorization') String token`

build_runner 실행

1

dart run build_runner build

.g.dart 파일이 생성된다. 코드가 바뀌면 다시 돌려야 하고, watch 모드로 자동 감지도 가능:

1

dart run build_runner watch

5. Freezed + json_serializable — 모델 클래스

왜 필요한가

서버에서 오는 JSON을 Map<String, dynamic>으로 쓰면:

1
2


final title = json['title'] as String; // 타입 캐스팅 필수
final id = json['id'] as int; // 키 오타나면 런타임 에러

타입 안전성이 없고, 필드가 10개면 지옥이다. Freezed + json_serializable은 이 문제를 코드 자동 생성으로 해결한다.

Freezed 모델 정의

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


@freezed
class Todo with _$Todo {
 const factory Todo({
 required int id,
 required String title,
 @Default(false) bool completed,
 DateTime? dueDate,
 }) = _Todo;

 factory Todo.fromJson(Map<String, dynamic> json) => _$TodoFromJson(json);
}

build_runner를 돌리면 자동으로 생성되는 것들:

fromJson / toJson — JSON ↔ 객체 변환
copyWith — 불변 객체의 일부 필드만 변경한 새 객체 생성
== / hashCode — 값 비교 (동일 값이면 같은 객체로 판단)
toString — 디버깅용 출력

@freezed vs @unfreezed

	@freezed	@unfreezed
불변성	불변 (immutable)	가변 (mutable)
수정 방법	`copyWith` (새 객체)	직접 필드 수정
용도	상태관리 모델, API 응답	폼 입력 등 자주 바뀌는 임시 데이터

실무에선 거의 @freezed만 쓴다. 상태관리에서 불변 객체가 변경 감지에 유리하기 때문.

Swift Codable과 비교

	Flutter (Freezed)	Swift (Codable)
정의	`@freezed class Todo`	`struct Todo: Codable`
JSON 변환	`fromJson` / `toJson`	`JSONDecoder` / `JSONEncoder`
불변성	`const factory`	`let` 프로퍼티
코드 생성	`build_runner` 필요	컴파일러가 자동
부분 수정	`copyWith`	직접 구현 필요

Swift의 Codable이 컴파일러 레벨에서 해주는 걸, Flutter는 build_runner로 해결한다. 좀 번거롭지만 결과물은 비슷하고, copyWith까지 공짜로 주니 오히려 편한 면도 있다.

copyWith 예시

1
2
3
4
5
6
7
8


final todo = Todo(id: 1, title: 'Flutter 공부', completed: false);

// 완료 상태만 변경한 새 객체
final done = todo.copyWith(completed: true);

// 원본은 변경되지 않음
print(todo.completed); // false
print(done.completed); // true

6. Riverpod 연동 — Provider로 서버 데이터 관리

Ch05에서 Riverpod의 기본을 다뤘으니, 여기서는 서버 데이터와 어떻게 연동하는가에 집중한다.

함수형 Provider = 읽기 (GET)

1
2
3
4
5


@riverpod
Future<List<Todo>> todoList(Ref ref) async {
 final api = ref.watch(todoApiProvider);
 return api.getTodos();
}

함수형으로 선언하면 읽기 전용. GET 요청으로 데이터를 가져오는 용도. 자동으로 AsyncValue가 되어 로딩/에러/성공 상태를 .when()으로 처리할 수 있다.

클래스형 Provider = CRUD

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


@riverpod
class TodoListNotifier extends _$TodoListNotifier {
 @override
 Future<List<Todo>> build() async {
 final api = ref.watch(todoApiProvider);
 return api.getTodos();
 }

 Future<void> addTodo(Todo todo) async {
 final api = ref.read(todoApiProvider);
 await api.createTodo(todo);
 ref.invalidateSelf(); // 목록 새로고침
 }

 Future<void> deleteTodo(int id) async {
 final api = ref.read(todoApiProvider);
 await api.deleteTodo(id);
 ref.invalidateSelf();
 }
}

클래스형으로 선언하면 메서드를 통해 쓰기(C/U/D) 가능. ref.invalidateSelf()를 호출하면 build()가 다시 실행되어 서버에서 최신 데이터를 가져온다.

ref.invalidate — 데이터 새로고침

1
2
3
4
5


// Provider 외부에서 새로고침
ref.invalidate(todoListNotifierProvider);

// Provider 내부에서 자기 자신 새로고침
ref.invalidateSelf();

“캐시를 버리고 다시 가져와"라는 의미. Pull-to-refresh 같은 기능에 딱이다.

Provider끼리 참조

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


@riverpod
TodoApi todoApi(Ref ref) {
 final dio = ref.watch(dioProvider);
 return TodoApi(dio);
}

@riverpod
Future<List<Todo>> todoList(Ref ref) async {
 final api = ref.watch(todoApiProvider); // 다른 Provider 참조
 return api.getTodos();
}

ref.watch로 다른 Provider를 참조하면, 의존하는 Provider가 바뀔 때 자동으로 다시 실행된다. Provider끼리의 의존성 그래프를 Riverpod이 알아서 관리해준다.

함수형 vs 클래스형 정리

	함수형 Provider	클래스형 Provider
선언	`@riverpod Future<T> func(Ref ref)`	`@riverpod class Notifier extends _$Notifier`
용도	읽기 전용 (GET)	CRUD 전체
상태 변경	불가 (외부에서 `invalidate`만)	메서드로 직접 변경
복잡도	단순	약간 복잡

규칙: 읽기만 하면 함수형, 쓰기도 하면 클래스형.

7. 전체 데이터 흐름 정리

이제 전체 파이프라인을 한 번에 보자.

요청 (뷰 → 서버)

1
2
3
4
5
6


1. 뷰에서 ref.watch(todoListNotifierProvider)
2. Provider의 build() 실행
3. Retrofit의 getTodos() 호출
4. Dio가 HTTP 요청 생성
5. AuthInterceptor가 토큰 자동 첨부
6. 서버로 GET /todos 전송

응답 (서버 → 뷰)

1
2
3
4
5
6


1. 서버가 JSON 응답
2. Dio가 응답 수신
3. Retrofit이 fromJson으로 List<Todo> 변환
4. Provider 상태에 저장 (AsyncData)
5. ref.watch가 변경 감지
6. 뷰의 .when()이 data 분기로 렌더링

에러 흐름 (토큰 만료)

1
2
3
4
5
6
7


1. 서버가 401 응답
2. Dio의 AuthInterceptor가 가로챔
3. Refresh Token으로 새 Access Token 발급
4. 원래 요청 재시도
5. 성공하면 정상 응답 흐름으로
6. 실패하면 Provider가 AsyncError 상태
7. 뷰의 .when()이 error 분기로 렌더링

각 레이어의 역할

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


┌─────────────┐
│ 뷰 │ ref.watch + .when()으로 상태별 UI
├─────────────┤
│ Provider │ 상태 관리 + 캐싱 + 새로고침
├─────────────┤
│ Retrofit │ API 인터페이스 → 구현 자동 생성
├─────────────┤
│ Dio │ HTTP 통신 + 인터셉터 (토큰, 로깅)
├─────────────┤
│ Freezed │ 불변 모델 + JSON 변환 자동 생성
├─────────────┤
│ 서버 │ REST API 제공
└─────────────┘

각 레이어가 자기 역할만 하고, 위아래로만 통신한다. 뷰는 Dio를 몰라도 되고, Retrofit은 인터셉터를 몰라도 된다. 관심사의 분리가 자연스럽게 이루어진다.

느낀 점

Ch05에서 상태관리의 “왜"를 이해했다면, Ch06은 “무엇을” 관리하는가에 대한 답이다. 로컬 리스트가 아니라 서버에서 오는 실제 데이터를 다루니까 비로소 앱다운 앱이 된다.

처음에 Dio, Retrofit, Freezed, json_serializable, build_runner… 패키지가 너무 많아서 “이게 다 필요해?“라는 생각이 들었다. 하지만 하나씩 쌓아보니 각각이 한 가지 문제를 확실히 해결하고 있었다:

Dio → HTTP 통신 + 인터셉터
Retrofit → API 보일러플레이트 제거
Freezed → 타입 안전한 불변 모델
Riverpod → 서버 데이터의 상태 관리

iOS에서 Alamofire + Moya + Codable 조합을 쓰던 것과 구조적으로 비슷하다. 프레임워크는 달라도 **“네트워크 레이어를 추상화하고, 모델을 자동 생성하고, 상태로 관리한다”**는 패턴은 동일하다.

다음 챕터에서는 이걸 실제 앱에 적용해본다.

Ch05-6. 아키텍처와 상태관리 총정리 - 정답은 없고 차이만 있다

Sun, 03 May 2026 02:00:00 +0900

Ch05 시리즈를 통해 같은 Todo 앱을 ValueNotifier → GetX → BLoC → Riverpod → Hooks까지 5가지 방식으로 다뤄봤다. 강의 마지막에 “그래서 뭘 써야 하나"에 대한 총정리가 나왔는데, 여기에 내 생각도 섞어서 정리한다.

왜 아키텍처를 고민하는가

많은 개발자들이 앱의 아키텍처를 궁금해하고, 어떻게 해야 좋은지 고뇌한다. 내 생각은 결국 쉬운 구조를 위해서가 아닐까 싶다.

그 “쉬운 구조"를 판단하는 기준은 크게 5가지로 나눌 수 있다.

1. 쉬운 개발

가장 직관적인 기준이다.

구조 파악이 쉬운가 — 코드를 처음 보는 사람도 흐름을 빠르게 이해할 수 있는가
작성하는 코드의 양이 적은가 — 보일러플레이트가 적을수록 생산성이 올라간다
가독성이 좋은가 — 6개월 뒤의 내가 봐도 바로 이해되는가

Ch05에서 직접 체감한 걸 돌아보면:

방식	보일러플레이트	진입 장벽	구조 파악
ValueNotifier	중간	낮음	쉬움
GetX	적음	낮음	쉬움
BLoC	많음	높음	Event 따라가면 명확
Riverpod	적음	중간	Provider 단위로 명확
Hooks + Riverpod	적음	중간	역할 분리 깔끔

BLoC은 Event/State/Bloc 클래스를 다 만들어야 하니까 코드량이 확실히 많다. 근데 그 대신 “이 이벤트가 이 상태를 바꾼다"가 명확해서 대규모 팀에서는 오히려 파악이 쉬울 수 있다. 결국 “쉬움"의 기준도 상황마다 다르다.

2. 안정성

여기서 말하는 안정성은 “앱이 잘 돌아가느냐"가 아니다.

일반적으로 코드를 짜면 코딩한 대로 동작하기 마련이다. 어떤 아키텍처를 쓰든, 어떤 상태관리를 쓰든, 출시 전에 개발자와 테스터가 테스트를 마치고 앱이 나가기 때문에 작동하지 않는 경우는 없다. 이런 관점에서는 모두 안정적이고 차이가 거의 없다.

여기서 말하는 안정성은 Test Code를 작성할 수 있는가다.

스펙이 변경되고 그에 따른 수정을 할 때, 예상하지 못한 버그가 일어나는 걸 최소화하려면 테스트 코드가 필요하다. 새 기능을 추가했는데 기존 기능이 깨지는 걸 사전에 잡아내는 것. 이게 진짜 안정성이다.

방식	테스트 용이성	이유
GetX (Static)	어려움	전역 상태라 격리가 힘듦
BLoC (Scoped)	좋음	Event 입력 → State 출력 검증이 깔끔
Riverpod (Scoped)	좋음	ProviderScope로 격리, override로 mock 주입
ValueNotifier (Scoped)	보통	가능하지만 편의 기능이 적음

3. 성능

사실 성능은 일반적인 모바일 앱에서는 거의 동일하다.

약 500만 번 정도의 연산이 일어나야 120Hz 렌더링을 방해할 수 있다 (애니메이션 예제 기준)
코드를 잘못 짜서 상호참조나 무한루프를 만드는 게 아닌 이상, 성능 차이를 체감하기는 어렵다
Flutter 자체가 **C 레벨의 네이티브(Skia/Impeller)**로 렌더링하기 때문에 성능이 워낙 좋다

물론 위젯 트리 구조대로 필요한 곳만 빌드하게 해서 성능을 최적화할 수는 있다. const 위젯이나 Consumer/BlocBuilder 같은 걸로 리빌드 범위를 줄이는 식으로.

하지만 배터리 타임이나 CPU 타임에 영향을 줄 정도로 아키텍처나 상태관리 패키지가 차이를 만들지는 않는다. 아키텍처 선택이 성능을 좌우한다는 건 사실상 미신이다.

4. 확장성

스펙이 바뀌거나 기능이 추가될 때, 기존 아키텍처가 유지되는 게 베스트다.

새 화면 추가할 때 기존 구조를 건드리지 않아도 되는가
상태 하나 추가할 때 수정 범위가 해당 모듈 안에서 끝나는가
팀원이 늘어나도 각자 독립적으로 작업할 수 있는가

Scoped 방식(BLoC, Riverpod)은 Provider/Bloc 단위로 관심사가 나뉘어 있어서 확장할 때 기존 코드를 건드릴 일이 적다. GetX도 Controller 단위로 나누면 되지만, 전역 접근이 가능하다는 특성상 의도치 않은 의존성이 생길 수 있다.

5. 제공되는 추가 기능들

각 패키지마다 별도로 제공하는 기능들이 있고, 이것도 선택에 영향을 준다.

패키지	특화 기능
GetX	라우팅, 다이얼로그, 스낵바, 다국어 — 올인원
BLoC	BlocObserver (Event 로깅), bloc_test
Riverpod	`.when` (비동기 분기), `family` (키 기반 상태), `@riverpod` 코드 생성
Hooks	Controller 자동 dispose, Custom Hook 재사용

GetX는 상태관리 외에도 네비게이션, UI 유틸리티까지 한 패키지에 들어있다. BLoC은 이벤트 추적에 강하다. Riverpod은 비동기 처리가 압도적이다. 프로젝트에서 어떤 기능이 중요한지에 따라 선택이 달라진다.

정답은 없다, 차이만 있다

아키텍처와 상태관리는 맞고 틀리고의 정답이 없다. ‘차이점’만 존재한다.

5가지 기준을 한눈에 정리하면:

기준	GetX	BLoC	Riverpod
쉬운 개발	쉬움	보일러플레이트 많음	적당함
안정성 (테스트)	격리 어려움	Event/State 검증 용이	override로 mock 주입
성능	동일	동일	동일
확장성	전역이라 의존성 주의	Bloc 단위 분리	Provider 단위 분리
추가 기능	올인원	Event 로깅	`.when`, `family`

Scoped vs Static — 접근성 다시 보기

Ch04에서 Scoped Model과 Static Model을 다뤘었다. 실제로 써보고 나니 “접근"에 대한 생각이 좀 바뀌었다.

모델	상태 접근 방식	대표
Scoped	`context.read()` (BLoC), `ref.read()` (Riverpod)	BLoC, Riverpod
Static	`Get.find()` — 어디서나 접근	GetX

Static이 언뜻 보면 쉬워 보인다. context니 ref니 하는 참조 엘리먼트를 안 써도 되니까. 하지만 실무적으로 살짝 불편할 뿐, 구조적으로는 접근에 문제가 없다.

애초에 앱을 실행시키는 main 함수에서 앱 객체를 만들 때부터 코드에서는 context와 ref를 참조할 수 있다. initState나 afterFirstLayout에서 context 접근이 가능하고, Riverpod은 ConsumerWidget만 쓰면 ref로 필요한 접근이 다 된다.

그렇기 때문에 “접근” 자체는 정말 사소하게 불편할 뿐, 참조를 연결만 한다면 구조적으로 언제나 접근이 된다고 봐도 무방하다.

진짜 차이가 나는 건 Widget Tree에 기반한 설계다.

Scoped 방식(BLoC, Riverpod)은 위젯 트리 위치에 따라 상태의 범위가 자연스럽게 정해진다. 화면이 닫히면 해당 스코프의 상태도 자동으로 정리된다.

GetX로 같은 걸 하려면 직접 구조를 구현해야 한다. 이전 블로그에서 다뤘듯이 임시 ID(tag)를 부여해서 관리해야 하는데, 해당 트리에 해당되는 위젯 생성자에 ID를 매번 전달하거나, InheritedWidget을 직접 구현해야 한다. 메모리 관리도 따로 해줘야 해서 오히려 더 불편해진다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


// Riverpod: 스코프가 자연스럽게 관리됨
ProviderScope(
 overrides: [commentProvider.overrideWith(() => CommentNotifier(videoId: id))],
 child: CommentSection(),
)
// 화면 닫히면 자동 정리

// GetX: tag로 직접 관리해야 함
Get.put(CommentController(videoId: id), tag: id);
// ...
Get.delete<CommentController>(tag: id); // 직접 정리

4가지 방식 최종 비교

Ch05 전체를 통해 같은 Todo 앱을 돌려본 결과:

	ValueNotifier	GetX	BLoC	Riverpod
모델	Scoped (내장)	Static	Scoped	Scoped
상태 변경	`notifyListeners()`	`.obs` 자동	`emit()`	`state =` 재할당
UI 구독	`ValueListenableBuilder`	`Obx`	`BlocBuilder`	`ref.watch`
비동기 분기	직접 처리	직접 처리	직접 처리	`.when` 자동
보일러플레이트	중간	적음	많음	적음
추적성	낮음	낮음	높음	중간
메모리 관리	자동	수동	자동	자동
테스트	보통	어려움	좋음	좋음
접근 방식	`context`	`Get.find()`	`context`	`ref`

여기에 Hooks를 더하면 로컬 UI 상태(useState, useTextEditingController)는 Hooks가, 공유 비즈니스 상태는 Riverpod이 맡아서 역할 분리가 깔끔해진다.

공부법에 대한 생각

Flutter를 공부해보니 몇 개월, 몇 년 이상 공부한 사람들은 패키지, 아키텍처, 상태관리 관련해서 블로그나 유튜브 등을 찾아보면서 시간을 꽤 많이 쓰지 않았을까 싶다. 물론 좋은 방향이지만, 너무 알아보고 너무 살펴보는 데 많은 시간을 쏟는다면 조금은 낭비가 아닐까 조심스레 생각해본다.

필자의 성격은 새로운 하나를 접하면(개발 외 모든 분야) A에서 Z까지 파보는 성격이다. 처음 개발을 접할 때도 그렇게 공부했다가 몇 달 만에 번아웃이 와버렸다.

이번에 Flutter를 새로 공부하면서 그 습관은 버리고, 직접 프로젝트에 적용해 가며 안 되는 것들을 찾아가고, 이를 해결하기 위해 직접 코드를 구현하거나 다른 패키지들을 도입해보면서 해결할 수 있는 능력을 길렀다. 해보지도 않고 이론에만 시간 쏟는 것보다 와닿는 게 훨씬 빨랐다.

물론 매우 주관적인 의견일 수 있다. 하지만 적어도 나한테는 이 방법이 맞았다:

일단 만들어본다 — Todo 앱 하나를 4가지 방식으로 전환해본 게 블로그 10개 읽는 것보다 나았다
안 되는 걸 찾아본다 — 필요할 때 찾아보는 게 기억에 남는다
비교는 직접 해본 뒤에 — 써보지도 않고 “BLoC vs Riverpod” 비교 글만 읽으면 감이 안 온다

마무리

앞으로 많은 프로젝트를 할 예정이고, 현재 운영 중인 iOS 네이티브 앱을 Flutter로 전환하는 계획도 있다. 상태관리, 아키텍처, 각종 패키지 등 프로젝트 상황에 맞게 잘 적용해보자.

Ch05 시리즈를 한 문장으로 정리하면:

아키텍처와 상태관리는 정답이 없다. 차이점만 있을 뿐이다. 직접 써보고 프로젝트에 맞는 걸 고르자.

Ch05-5. Flutter Hooks + Riverpod - SwiftUI @State가 여기 있었네

Sun, 03 May 2026 01:00:00 +0900

강의에서 Hooks 부분은 눈으로만 봤는데, SwiftUI의 @State랑 너무 비슷해서 정리하지 않으면 아까울 것 같았다. StatefulWidget의 보일러플레이트가 싫었던 사람이라면 Hooks를 보는 순간 “이걸 왜 이제 알았지” 싶을 거다.

StatefulWidget, 뭐가 불편한가

간단한 카운터 하나 만드는데 이만큼 써야 한다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21


class CounterPage extends StatefulWidget {
 const CounterPage({super.key});

 @override
 State<CounterPage> createState() => _CounterPageState();
}

class _CounterPageState extends State<CounterPage> {
 int _count = 0;

 @override
 Widget build(BuildContext context) {
 return Scaffold(
 body: Center(child: Text('$_count')),
 floatingActionButton: FloatingActionButton(
 onPressed: () => setState(() => _count++),
 child: const Icon(Icons.add),
 ),
 );
 }
}

StatefulWidget 클래스 + State 클래스, 2개를 만들어야 한다. createState() 보일러플레이트도 매번 써야 하고. 상태 변수가 하나인데도 이 정도다. TextEditingController나 AnimationController가 들어오면 initState에서 초기화하고 dispose에서 해제하는 코드까지 추가된다.

React에서 이 문제를 Hooks로 해결했고, Riverpod을 만든 Remi Rousselet이 Flutter 버전으로 flutter_hooks를 만들었다.

HookWidget — 2개 클래스가 1개로

같은 카운터를 Hooks로 바꾸면:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


class CounterPage extends HookWidget {
 const CounterPage({super.key});

 @override
 Widget build(BuildContext context) {
 final count = useState(0);

 return Scaffold(
 body: Center(child: Text('${count.value}')),
 floatingActionButton: FloatingActionButton(
 onPressed: () => count.value++,
 child: const Icon(Icons.add),
 ),
 );
 }
}

StatefulWidget + State 2개 클래스 → HookWidget 1개. createState() 보일러플레이트 사라짐. 상태 선언이 build 메서드 안에서 한 줄로 끝난다.

SwiftUI 개발자라면 바로 느낌 올 거다:

1
2
3
4
5
6
7
8
9


// SwiftUI
struct CounterPage: View {
 @State private var count = 0

 var body: some View {
 Text("\(count)")
 Button("+") { count += 1 }
 }
}

@State가 useState고, .value로 접근하는 것만 다르다.

핵심 Hooks

useState — 로컬 상태 관리

1
2
3


final count = useState(0); // int
final name = useState(''); // String
final isLoading = useState(false); // bool

useState<T>(initialValue)는 ValueNotifier<T>를 내부적으로 만들고, .value가 바뀌면 위젯을 자동으로 리빌드한다. setState(() { ... })를 직접 호출할 필요가 없다.

Flutter Hooks	SwiftUI	설명
`useState(0)`	`@State var count = 0`	로컬 상태 선언
`count.value`	`count`	값 읽기
`count.value++`	`count += 1`	값 변경 → 자동 리빌드

useEffect — 생명주기 처리

initState + dispose를 하나로 합친 것이다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


@override
Widget build(BuildContext context) {
 // 마운트 시 실행, 리턴 함수는 dispose 시 실행
 useEffect(() {
 final subscription = stream.listen(print);
 return subscription.cancel; // cleanup = dispose
 }, []); // [] = 마운트 시 1회만

 // 특정 값이 바뀔 때마다 실행
 final userId = useState(1);
 useEffect(() {
 fetchUser(userId.value);
 return null; // cleanup 불필요
 }, [userId.value]); // userId가 바뀔 때마다

 return ...;
}

두 번째 인자(keys)가 핵심이다:

keys	동작	SwiftUI 대응
`[]`	마운트 시 1회	`.onAppear`
`[value]`	value 변경 시	`.onChange(of: value)`
생략	매 빌드마다	-
return 함수	위젯 제거 시 실행	`.onDisappear`

useMemoized — 비싼 연산 캐싱

1
2


// 매 빌드마다 재계산되는 걸 방지
final expensive = useMemoized(() => heavyComputation(data), [data]);

keys가 바뀔 때만 재계산한다. SwiftUI의 캐싱은 뷰 자체가 struct라서 자동으로 되는 부분이 있는데, Flutter는 build가 매번 호출되니까 직접 메모이제이션해야 한다.

Controller 계열 — 자동 dispose가 핵심

StatefulWidget에서 Controller를 쓰면 항상 이 패턴이 반복된다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


// StatefulWidget 방식: 초기화 + 해제를 직접 관리
class _MyState extends State<MyWidget> {
 late TextEditingController _controller;
 late AnimationController _animController;

 @override
 void initState() {
 super.initState();
 _controller = TextEditingController();
 _animController = AnimationController(
 vsync: this,
 duration: const Duration(milliseconds: 300),
 );
 }

 @override
 void dispose() {
 _controller.dispose();
 _animController.dispose();
 super.dispose();
 }
}

Hooks로 바꾸면:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


// Hooks: 한 줄이면 끝, dispose 자동
@override
Widget build(BuildContext context) {
 final controller = useTextEditingController();
 final animController = useAnimationController(
 duration: const Duration(milliseconds: 300),
 );
 final tabController = useTabController(initialLength: 3);
 final focusNode = useFocusNode();
 final scrollController = useScrollController();

 return ...;
}

Hook	대체하는 것	자동 dispose
`useTextEditingController()`	`TextEditingController` + dispose	O
`useAnimationController()`	`AnimationController` + TickerProvider + dispose	O
`useTabController()`	`TabController` + dispose	O
`useFocusNode()`	`FocusNode` + dispose	O
`useScrollController()`	`ScrollController` + dispose	O

initState에서 만들고 dispose에서 해제하는 그 반복 패턴이 완전히 사라진다. 특히 useAnimationController는 TickerProviderStateMixin도 자동으로 처리해주니까 with SingleTickerProviderStateMixin 같은 mixin도 필요 없다.

useRef — 리빌드 없이 값 유지

1
2


final renderCount = useRef(0);
renderCount.value++; // 이걸 바꿔도 리빌드 안 됨

useState와 달리 값이 바뀌어도 리빌드를 트리거하지 않는다. 렌더링 횟수 추적, 이전 값 기억 같은 용도로 쓴다.

Hook 규칙 3가지

React Hooks와 같은 규칙이다. 어기면 버그가 난다:

1. 조건문 안에서 호출 금지

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


// 나쁜 예
if (isLoggedIn) {
 final name = useState(''); // 조건에 따라 Hook 호출 순서가 바뀜
}

// 좋은 예
final name = useState('');
if (isLoggedIn) {
 // name.value 사용
}

2. 항상 같은 순서로 호출

1
2
3
4


// 항상 이 순서대로 호출돼야 함
final count = useState(0);
final name = useState('');
final isLoading = useState(false);

Hooks는 내부적으로 호출 순서로 상태를 추적한다. 순서가 바뀌면 엉뚱한 값이 매칭된다.

3. `use` 접두어

커스텀 Hook을 만들 때 use로 시작해야 한다. 컨벤션이자 Hooks임을 표시하는 약속이다.

Custom Hook 만들기

반복되는 Hook 조합을 함수로 추출하면 된다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25


// 디바운스된 값을 반환하는 커스텀 Hook
ValueNotifier<T> useDebounced<T>(T value, {Duration delay = const Duration(milliseconds: 500)}) {
 final debounced = useState(value);

 useEffect(() {
 final timer = Timer(delay, () => debounced.value = value);
 return timer.cancel; // 이전 타이머 정리
 }, [value, delay]);

 return debounced;
}

// 사용
@override
Widget build(BuildContext context) {
 final searchText = useState('');
 final debouncedText = useDebounced(searchText.value);

 useEffect(() {
 searchApi(debouncedText.value);
 return null;
 }, [debouncedText.value]);

 return TextField(onChanged: (v) => searchText.value = v);
}

꿀팁 패턴들

useMemoized + useFuture — API 캐싱

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


@override
Widget build(BuildContext context) {
 // useMemoized로 Future를 캐싱 → 리빌드해도 API 재호출 안 함
 final future = useMemoized(() => fetchUserData(), []);
 final snapshot = useFuture(future);

 if (snapshot.connectionState == ConnectionState.waiting) {
 return const CircularProgressIndicator();
 }

 if (snapshot.hasError) {
 return Text('에러: ${snapshot.error}');
 }

 return Text('${snapshot.data?.name}');
}

useMemoized 없이 useFuture(fetchUserData())를 쓰면 매 빌드마다 새 Future가 만들어져서 API가 무한 호출된다. useMemoized로 Future 자체를 캐싱하는 게 핵심이다.

useDebounced — 검색 디바운싱

위의 Custom Hook 예제가 바로 이 패턴이다. 검색창에서 타이핑할 때마다 API를 호출하지 않고, 사용자가 타이핑을 멈춘 뒤 500ms 후에 한 번만 호출한다. 실무에서 검색 자동완성에 거의 필수다.

Riverpod + Hooks 조합

여기서 진짜 빛난다. hooks_riverpod 패키지의 HookConsumerWidget을 쓰면 Hooks(로컬 상태) + **Riverpod(공유 상태)**를 한 위젯에서 쓸 수 있다.

역할 분리

역할	도구	예시
로컬 UI 상태	Hooks (`useState`, `useAnimationController`)	텍스트 입력, 애니메이션, 토글
공유 비즈니스 상태	Riverpod (`ref.watch`, `ref.read`)	유저 데이터, Todo 목록, API

코드 예제

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49


// HookConsumerWidget = HookWidget + ConsumerWidget
class TodoPage extends HookConsumerWidget {
 const TodoPage({super.key});

 @override
 Widget build(BuildContext context, WidgetRef ref) {
 // Hooks: 로컬 상태
 final controller = useTextEditingController();
 final focusNode = useFocusNode();
 final isExpanded = useState(false);

 // Riverpod: 공유 상태
 final todoList = ref.watch(todoDataProvider);

 return Scaffold(
 appBar: AppBar(title: const Text('Todo')),
 body: Column(
 children: [
 // 로컬 상태: 입력 필드 (이 화면에서만 필요)
 TextField(
 controller: controller,
 focusNode: focusNode,
 decoration: const InputDecoration(hintText: '할 일 입력'),
 ),
 ElevatedButton(
 onPressed: () {
 // Riverpod: 공유 상태 변경
 ref.read(todoDataProvider.notifier).addTodo(
 Todo(title: controller.text),
 );
 controller.clear();
 focusNode.requestFocus();
 },
 child: const Text('추가'),
 ),
 // Riverpod: 공유 상태 구독
 Expanded(
 child: ListView.builder(
 itemCount: todoList.length,
 itemBuilder: (context, index) => ListTile(
 title: Text(todoList[index].title),
 ),
 ),
 ),
 ],
 ),
 );
 }
}

ConsumerStatefulWidget에서는 TextEditingController 초기화 + dispose를 직접 했어야 했다. HookConsumerWidget에서는 useTextEditingController() 한 줄이면 끝이다. Riverpod의 ref.watch/ref.read도 그대로 쓸 수 있다.

위젯 타입 정리

위젯	상속 대상	Hooks	Riverpod
`StatelessWidget`	-	X	X
`HookWidget`	`StatelessWidget`	O	X
`ConsumerWidget`	`StatelessWidget`	X	O
`HookConsumerWidget`	`StatelessWidget`	O	O

HookConsumerWidget 하나면 로컬 상태도 공유 상태도 다 된다. 실무에서 가장 많이 쓰는 조합이다.

생산성 라이브러리

패키지	역할	비고
`flutter_hooks`	핵심 Hooks (`useState`, `useEffect` 등)	Remi Rousselet 제작
`hooks_riverpod`	Hooks + Riverpod 조합 (`HookConsumerWidget`)	Riverpod 공식
`flutter_use`	추가 Hooks 모음 (`useDebounce`, `usePrevious` 등)	커뮤니티

flutter_hooks + hooks_riverpod만 있으면 거의 모든 상황을 커버한다. flutter_use는 자주 쓰는 패턴을 미리 만들어둔 편의 패키지다.

SwiftUI와 최종 비교

개념	Flutter Hooks	SwiftUI
로컬 상태	`useState`	`@State`
값 접근	`.value`	직접 접근
생명주기 진입	`useEffect(() {}, [])`	`.onAppear`
값 변경 감지	`useEffect(() {}, [value])`	`.onChange(of: value)`
정리/해제	`useEffect`의 return	`.onDisappear`
컨트롤러 관리	`useTextEditingController()` 등 (자동 dispose)	`@StateObject` (자동 관리)
비싼 연산 캐싱	`useMemoized`	뷰가 struct라 자동 최적화
리빌드 없는 값	`useRef`	일반 `let` 변수
공유 상태	Riverpod (`ref.watch`)	`@EnvironmentObject`, `@Observable`

SwiftUI는 프로퍼티 래퍼(@State, @Binding, @StateObject)로 선언형 상태를 관리하고, Flutter Hooks는 use 함수로 같은 역할을 한다. 접근 방식은 다르지만 “선언적으로 상태를 관리하고, 변경 시 UI가 자동으로 반영된다"는 핵심은 동일하다.

내가 느낀 점

SwiftUI에서 @State 쓰던 경험이 있어서 useState가 바로 이해됐다. “아, 이거 @State랑 같은 거잖아.” 그리고 useTextEditingController처럼 Controller를 자동으로 dispose해주는 게 진짜 편하다. StatefulWidget에서 initState + dispose 짝 맞추는 거 매번 귀찮았는데, 이게 한 줄로 끝나니까.

Riverpod과 조합하면 역할 분리가 깔끔해진다:

로컬 UI 상태 (텍스트 입력, 애니메이션, 토글) → Hooks
공유 비즈니스 상태 (Todo 목록, 유저 데이터, API) → Riverpod

ConsumerStatefulWidget에서 하던 걸 HookConsumerWidget으로 바꾸면 코드가 절반으로 줄어든다. StatefulWidget의 보일러플레이트에서 해방된 느낌이다.

Ch05-4. Todo 앱 Riverpod 전환 - 이게 진짜 사기다

Sat, 02 May 2026 00:00:00 +0900

Ch05 시리즈 마지막이다. BLoC에서 Riverpod으로 전환한다. 솔직히 BLoC의 Event 기반 구조가 MVI 느낌이라 꽤 마음에 들었는데, Riverpod 써보니까 생산성이 말이 안 된다. 뷰에서 상태별 분기가 .when 하나로 되고, BLoC에서 필요했던 Event 클래스, State 래퍼, Emitter 전달 같은 보일러플레이트가 싹 사라진다.

이 글의 코드는 flutter_riverpod 2.6.1 기준이다. 최신 Riverpod 3.0과의 차이점은 글 하단에 정리했다.

BLoC → Riverpod, 뭐가 바뀌나

영역	BLoC	Riverpod
상태 클래스	`Bloc<Event, State>` 상속	`StateNotifier<T>` 상속
이벤트	`sealed class TodoEvent` 별도 정의	없음. 메서드 직접 호출
State 래퍼	`@freezed TodoBlocState`	직접 `List<Todo>`
등록	`BlocProvider(create: ...)`	`StateNotifierProvider(...)` 전역 선언
UI 위젯	`StatelessWidget` + `BlocBuilder`	`ConsumerWidget`
접근	`context.read<TodoBloc>()`	`ref.read(provider.notifier)`
구독	`BlocBuilder<TodoBloc, TodoBlocState>`	`ref.watch(provider)`
상태 발행	`emit(state.copyWith(...))`	`state = newValue`

요약하면 BLoC에서 Event 클래스 + State 래퍼 + Emitter 패턴이 전부 사라지고, 직접 메서드 호출 + state 재할당으로 단순해진다.

StateNotifierProvider — 핵심 구조

Provider 선언 (전역)

1
2
3


final todoDataProvider =
 StateNotifierProvider<TodoDataHolder, List<Todo>>(
 (ref) => TodoDataHolder());

이게 끝이다. BLoC에서는 BlocProvider로 위젯 트리에 감싸야 했는데, Riverpod은 전역 변수처럼 선언한다. “provider가 전역으로 선언되었다고 데이터도 전역으로 같이 쓰는 게 아니다” — 이건 뒤에서 Scope로 설명한다.

StateNotifier 구현

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46


class TodoDataHolder extends StateNotifier<List<Todo>> {
 TodoDataHolder() : super(<Todo>[]);

 void addTodo() async {
 final result = await WriteTodoDialog().show();
 if (result != null) {
 state.add(
 Todo(
 id: DateTime.now().microsecondsSinceEpoch,
 title: result.text,
 dueDate: result.dateTime,
 ),
 );
 state = List.of(state); // 새 리스트로 재할당 → 리빌드 트리거
 }
 }

 void changeTodoStatus(Todo todo) async {
 switch (todo.status) {
 case TodoStatus.inComplete:
 todo.status = TodoStatus.onGoing;
 case TodoStatus.onGoing:
 todo.status = TodoStatus.complete;
 case TodoStatus.complete:
 final result = await ConfirmDialog('정말로 처음 상태로 변경하시겠어요?').show();
 result?.runIfSuccess((data) {
 todo.status = TodoStatus.inComplete;
 });
 }
 state = List.of(state);
 }

 void editTodo(Todo todo) async {
 final result = await WriteTodoDialog(todoForEdit: todo).show();
 if (result != null) {
 todo.title = result.text;
 todo.dueDate = result.dateTime;
 state = List.of(state);
 }
 }

 void removeTodo(Todo todo) {
 state.remove(todo);
 state = List.of(state);
 }
}

BLoC에서는 emit(state.copyWith(todoList: oldTodoList))로 새 State를 발행했는데, Riverpod에서는 state = List.of(state)로 직접 재할당한다. state에 새 값을 넣으면 구독 중인 위젯이 자동으로 리빌드된다.

BLoC과 비교하면:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


// BLoC: Event를 정의하고, 핸들러를 등록하고, Emitter로 발행
sealed class TodoEvent {}
class TodoAddEvent extends TodoEvent {}

class TodoBloc extends Bloc<TodoEvent, TodoBlocState> {
 TodoBloc() : super(...) {
 on<TodoAddEvent>(_addTodo); // 핸들러 등록
 }
 void _addTodo(TodoAddEvent event, Emitter<TodoBlocState> emit) {
 emit(state.copyWith(todoList: newList)); // Emitter로 발행
 }
}

// Riverpod: 그냥 메서드 쓰면 됨
class TodoDataHolder extends StateNotifier<List<Todo>> {
 void addTodo() {
 state = List.of(state); // state 재할당이 곧 발행
 }
}

Event 클래스 정의 → 핸들러 등록 → Emitter 전달 → emit 호출. 이 4단계가 state 재할당 한 줄로 줄었다.

Extension으로 접근 축약

1
2
3


extension TodoListHolderProvider on WidgetRef {
 TodoDataHolder get readTodoHolder => read(todoDataProvider.notifier);
}

ref.read(todoDataProvider.notifier).addTodo() 대신 ref.readTodoHolder.addTodo()로 쓸 수 있다. BLoC에서 context.readTodoBloc으로 축약했던 것과 같은 패턴이다.

ConsumerWidget — UI에서 사용

ProviderScope 설정

1
2
3
4
5
6
7
8
9


// s_main.dart
class MainScreenWrapper extends StatelessWidget {
 const MainScreenWrapper({super.key});

 @override
 Widget build(BuildContext context) {
 return const ProviderScope(child: MainScreen());
 }
}

ProviderScope은 Riverpod의 DI 컨테이너다. 이 안에 있는 위젯들이 Provider에 접근할 수 있다. BLoC의 BlocProvider와 같은 역할이지만, 여러 Provider를 개별적으로 감쌀 필요 없이 하나의 ProviderScope만 있으면 된다.

ConsumerWidget으로 구독

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


// w_todo_list.dart
class TodoList extends ConsumerWidget {
 const TodoList({super.key});

 @override
 Widget build(BuildContext context, WidgetRef ref) {
 final todoList = ref.watch(todoDataProvider); // 구독

 return todoList.isEmpty
 ? const Expanded(
 child: Center(
 child: Text('할 일을 작성해 보세요.',
 style: TextStyle(fontSize: 32)),
 ),
 )
 : Column(
 children: todoList.map((e) => TodoItem(e)).toList(),
 );
 }
}

BLoC에서는 BlocBuilder<TodoBloc, TodoBlocState> 위젯으로 감싸야 했는데, Riverpod은 ConsumerWidget을 상속하면 build 메서드에 WidgetRef ref가 들어온다. ref.watch(provider)로 구독하면 state가 바뀔 때마다 자동 리빌드된다.

ref.watch vs ref.read

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31


// w_todo_item.dart
class TodoItem extends ConsumerWidget {
 final Todo todo;

 const TodoItem(this.todo, {super.key});

 @override
 Widget build(BuildContext context, WidgetRef ref) {
 return Dismissible(
 key: ValueKey(todo.id),
 onDismissed: (direction) {
 ref.readTodoHolder.removeTodo(todo); // ref.read: 한 번 읽기
 },
 child: RoundedContainer(
 child: Row(
 children: [
 TodoStatusWidget(todo),
 Text(todo.title),
 const Spacer(),
 IconButton(
 onPressed: () {
 ref.readTodoHolder.editTodo(todo); // ref.read: 이벤트용
 },
 icon: const Icon(EvaIcons.editOutline),
 )
 ],
 ),
 ),
 );
 }
}

메서드	용도	리빌드
`ref.watch(provider)`	상태 구독 (UI 그릴 때)	O
`ref.read(provider.notifier)`	메서드 호출 (이벤트용)	X

BLoC의 context.watch / context.read와 정확히 같은 개념이다. 차이라면 BLoC은 context에서 꺼내고, Riverpod은 ref에서 꺼낸다.

ConsumerStatefulWidget

Rive 애니메이션처럼 lifecycle 메서드가 필요하면 ConsumerStatefulWidget을 쓴다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33


class TodoStatusWidget extends ConsumerStatefulWidget {
 final Todo todo;

 const TodoStatusWidget(this.todo, {super.key});

 @override
 ConsumerState<TodoStatusWidget> createState() => _TodoStatusWidgetState();
}

class _TodoStatusWidgetState extends ConsumerState<TodoStatusWidget> {
 // initState, dispose 등 lifecycle 사용 가능
 // ref도 사용 가능

 @override
 Widget build(BuildContext context) {
 return Tap(
 onTap: () {
 ref.readTodoHolder.changeTodoStatus(widget.todo);
 },
 child: SizedBox(
 width: 50,
 height: 50,
 child: switch (widget.todo.status) {
 TodoStatus.complete => Checkbox(value: true, onChanged: null),
 TodoStatus.inComplete => const Checkbox(value: false, onChanged: null),
 TodoStatus.onGoing => _riveReady
 ? RiveWidget(controller: _controller!, fit: Fit.cover)
 : const SizedBox(),
 },
 ),
 );
 }
}

위젯 타입	BLoC 대응	언제 쓰나
`ConsumerWidget`	`StatelessWidget` + `BlocBuilder`	단순 UI
`ConsumerStatefulWidget`	`StatefulWidget` + `BlocBuilder`	lifecycle 필요

ProviderScope — 스코프 개념

Provider가 전역으로 선언되었다고 데이터도 전역으로 같이 쓰는 게 아니다. ProviderScope으로 나눠주면 별도의 데이터를 가지게 된다.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


// 같은 Provider인데 Scope가 다르면 다른 데이터
ProviderScope(
 overrides: [todoDataProvider.overrideWith(() => TodoDataHolder())],
 child: ScreenA(), // 이 안에서는 독립된 TodoDataHolder
)

ProviderScope(
 overrides: [todoDataProvider.overrideWith(() => TodoDataHolder())],
 child: ScreenB(), // 여기도 독립된 TodoDataHolder
)

Ch04에서 다뤘던 Scoped Model의 진짜 실현이다. BLoC에서는 BlocProvider를 위젯 트리 특정 위치에 넣어서 스코프를 만들었는데, Riverpod은 ProviderScope의 overrides로 더 유연하게 스코프를 지정할 수 있다.

유튜브 앱에서 영상마다 다른 댓글 리스트를 보여줘야 한다면:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


// BLoC: 각 화면에 BlocProvider를 별도로 감싸야 함
BlocProvider(
 create: (_) => CommentBloc(videoId: 'abc123'),
 child: CommentSection(),
)

// Riverpod: ProviderScope로 override
ProviderScope(
 overrides: [commentProvider.overrideWith(() => CommentNotifier(videoId: 'abc123'))],
 child: CommentSection(),
)

사실 결과적으로 비슷하지만, Riverpod은 Provider 선언이 전역이니까 어떤 Provider들이 있는지 한눈에 파악이 된다. BLoC은 각 화면의 BlocProvider를 찾아다녀야 한다.

FutureProvider — 비동기 상태의 끝판왕

Todo 앱에서는 안 썼지만, 실제 앱을 만들면 API 호출이 필수다. 여기서 Riverpod의 진가가 나온다.

기본 사용법

1
2
3
4


final userProvider = FutureProvider<User>((ref) async {
 final response = await http.get(Uri.parse('https://api.com/user'));
 return User.fromJson(jsonDecode(response.body));
});

이걸 뷰에서 쓰면:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


class UserPage extends ConsumerWidget {
 @override
 Widget build(BuildContext context, WidgetRef ref) {
 final userAsync = ref.watch(userProvider);

 return Scaffold(
 body: Center(
 child: userAsync.when(
 loading: () => CircularProgressIndicator(),
 error: (e, _) => Text('에러: $e'),
 data: (user) => Text(user.name),
 ),
 ),
 );
 }
}

.when 하나로 로딩/에러/데이터 분기가 끝난다. 세 가지 상태를 빠뜨릴 수가 없어서 안전하기도 하다. Swift에서 비슷하게 하려면:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


// Swift - 직접 분기 처리
var body: some View {
 if isLoading {
 ProgressView()
 } else if let error {
 Text("에러: \(error)")
 } else if let user {
 Text(user.name)
 }
}

이걸 .when 하나로 끝내는 거다.

화면 일부만 분기하기

.when이 화면 전체를 교체하는 것만은 아니다. 부분에도 쓸 수 있다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


Scaffold(
 appBar: AppBar(title: Text('마이페이지')), // 고정
 body: Column(
 children: [
 Text('항상 보이는 영역'), // 고정

 // 이 부분만 로딩/에러/데이터 처리
 ref.watch(userProvider).when(
 loading: () => CircularProgressIndicator(),
 error: (e, _) => Text('로드 실패'),
 data: (user) => UserCard(user: user),
 ),

 Text('여기도 항상 보임'), // 고정
 ],
 ),
)

프로필 페이지, 상품 목록, 검색 결과 같은 데서 엄청 자주 쓰는 패턴이다. loading이나 error 분기에도 커스텀 위젯을 자유롭게 넣을 수 있다:

1
2
3
4
5
6
7
8


ref.watch(userProvider).when(
 loading: () => ShimmerSkeleton(), // 스켈레톤 UI
 error: (e, _) => ErrorRetryWidget(
 message: '불러오기 실패',
 onRetry: () => ref.invalidate(userProvider), // 재시도
 ),
 data: (user) => UserProfileCard(user: user),
)

ref.listen — 오버레이 로딩

.when은 화면의 특정 영역을 교체하는 방식이다. 기존 화면 위에 오버레이로 로딩을 띄우고 싶다면 ref.listen을 쓴다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34


class LoginPage extends ConsumerWidget {
 @override
 Widget build(BuildContext context, WidgetRef ref) {
 // 상태 변화를 '듣고' 오버레이 처리
 ref.listen(loginProvider, (prev, next) {
 if (next.isLoading) {
 showDialog(
 context: context,
 builder: (_) => Center(child: CircularProgressIndicator()),
 );
 } else {
 Navigator.of(context).pop(); // 로딩 닫기
 next.whenOrNull(
 error: (e, _) => ScaffoldMessenger.of(context)
 .showSnackBar(SnackBar(content: Text('실패: $e'))),
 data: (user) => Navigator.pushReplacement(...),
 );
 }
 });

 // 메인 UI는 그대로
 return Scaffold(
 body: Column(
 children: [
 TextField(...),
 ElevatedButton(
 onPressed: () => ref.read(loginProvider.notifier).login(),
 child: Text('로그인'),
 ),
 ],
 ),
 );
 }
}

상황	방식
화면 영역이 로딩/에러/데이터로 교체	`ref.watch` + `.when`
기존 화면 위에 오버레이 로딩	`ref.listen` + `showDialog`
데이터만 필요하고 로딩 무시	`.valueOrNull`

when은 화면 교체용, listen은 이벤트 반응용이다.

@riverpod — 코드 제너레이션

지금까지 StateNotifierProvider<TodoDataHolder, List<Todo>>((ref) => ...) 같은 긴 타입을 직접 썼는데, @riverpod을 쓰면 이 보일러플레이트도 자동 생성된다:

1
2
3
4
5
6
7
8
9


// @riverpod 방식: 함수 쓰듯이 로직만 짜면 끝
@riverpod
Future<User> user(ref) async {
 final response = await http.get(Uri.parse('https://api.com/user'));
 return User.fromJson(jsonDecode(response.body));
}

// build_runner 돌리면 userProvider가 자동 생성됨
// 뷰에서 ref.watch(userProvider).when(...) 으로 사용

알아야 하는 건 3개뿐이다:

@riverpod 붙이고 로직 짜기
build_runner 돌려서 코드 생성
뷰에서 ref.watch / ref.read로 사용

StateNotifierProvider<TodoNotifier, List<Todo>>((ref) => ...) 이런 보일러플레이트를 직접 안 짜도 된다. 요즘 새 프로젝트는 대부분 @riverpod 방식을 쓴다.

BLoC vs Riverpod 최종 비교

코드 비교

항목	BLoC	Riverpod
방식	Event → Bloc → State	직접 메서드 호출
이벤트 정의	`sealed class TodoEvent` + 하위 클래스 4개	없음
State 래퍼	`@freezed TodoBlocState` (BlocStatus 포함)	직접 `List<Todo>`
등록	`BlocProvider` (위젯 트리)	`StateNotifierProvider` (전역 선언)
UI 위젯	`BlocBuilder` 래퍼	`ConsumerWidget` 상속
상태 발행	`emit(state.copyWith(...))`	`state = newValue`
비동기 분기	직접 처리	`.when(loading, error, data)`
Event 추적	BlocObserver로 가능	직접 로깅 필요
보일러플레이트	많음	적음
스코프	BlocProvider 위치	ProviderScope overrides

같은 “Todo 삭제” 동작

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30


// BLoC: Event 정의 → 핸들러 등록 → Event dispatch
// 1. Event 정의
class TodoRemoveEvent extends TodoEvent {
 final Todo removedTodo;
 TodoRemoveEvent(this.removedTodo);
}

// 2. 핸들러 등록
on<TodoRemoveEvent>(_removeTodo);

// 3. 핸들러 구현
void _removeTodo(TodoRemoveEvent event, Emitter<TodoBlocState> emit) {
 final oldTodoList = List<Todo>.from(state.todoList);
 oldTodoList.removeWhere((e) => e.id == event.removedTodo.id);
 emit(state.copyWith(todoList: oldTodoList));
}

// 4. UI에서 dispatch
context.readTodoBloc.add(TodoRemoveEvent(todo));


// Riverpod: 메서드 하나
// 1. 메서드 구현
void removeTodo(Todo todo) {
 state.remove(todo);
 state = List.of(state);
}

// 2. UI에서 호출
ref.readTodoHolder.removeTodo(todo);

BLoC은 4단계, Riverpod은 2단계. 추적성 vs 생산성의 트레이드오프다.

언제 뭘 쓸까

상황	추천
대규모 팀 (10명+)	BLoC — Event 히스토리 추적, 팀 컨벤션 강제
소규모 팀 / 개인	Riverpod — 생산성, 적은 보일러플레이트
API 호출 많은 앱	Riverpod — `.when` 패턴이 압도적
Event 로깅 필수	BLoC — BlocObserver
프로토타입	Riverpod (또는 GetX)

2026년 기준으로 새 프로젝트는 대부분 Riverpod이 기본 선택이고, BLoC은 대규모 엔터프라이즈에서 쓰이는 추세다.

4가지 방식 총 비교

Ch05 전체를 통해 같은 Todo 앱을 4가지 방식으로 만들어봤다:

	ValueNotifier	GetX	BLoC	Riverpod
방식	Scoped (내장)	Static	Scoped	Scoped
상태 변경	`notifyListeners()`	`.obs` 자동	`emit()`	`state =` 재할당
UI 구독	`ValueListenableBuilder`	`Obx`	`BlocBuilder`	`ref.watch`
비동기 분기	직접 처리	직접 처리	직접 처리	`.when` 자동
보일러플레이트	중간	적음	많음	적음
추적성	낮음	낮음	높음	중간
메모리 관리	자동	수동	자동	자동

내가 느낀 점

BLoC의 Event 기반 구조가 사실상 Scope 역할을 하는 거라고 느꼈다. 어떤 이벤트가 어떤 상태를 바꾸는지 명확히 분리되니까. 근데 Riverpod은 Provider 단위로 관심사를 나누면서도 코드량이 훨씬 적다.

1
2
3
4


// 관심사 분리: Provider 단위로 나누면 됨
final todoDataProvider = StateNotifierProvider<TodoDataHolder, List<Todo>>(...);
final userProvider = FutureProvider<User>(...);
final settingsProvider = StateNotifierProvider<SettingsNotifier, Settings>(...);

젤 좋은 건 뷰에서 상태별 화면 분기가 .when 하나로 되는 점이다. 로딩/에러/데이터를 빠뜨릴 수 없게 강제하니까 안전하고, 각 분기에 아무 위젯이나 넣을 수 있으니까 커스텀도 자유롭다.

앱이 커져서 상태가 많아지면 Provider를 나누면 되고, Scope가 필요하면 ProviderScope의 overrides로 해결된다. 개인 프로젝트에서 쓴다면 Riverpod이 정답인 것 같다.

Riverpod 3.0 — 2025년 9월 기준 변경점

이 글에서 쓴 코드는 Riverpod 2.x 기반이다. 2025년 9월에 Riverpod 3.0이 나왔는데, 핵심 개념(ref.watch, ref.read, .when, ProviderScope)은 그대로고 보일러플레이트가 더 줄었다.

	Riverpod 2.x (이 글)	Riverpod 3.0
Provider 선언	`StateNotifierProvider<T, S>((ref) => ...)` 직접 작성	`@riverpod` 붙이면 자동 생성
상태 클래스	`StateNotifier<T>`	`Notifier<T>` (`StateNotifier` deprecated)
비동기	`FutureProvider` 별도 선언	`@riverpod Future<T>` 함수로 통일
Mutation	없음	`@mutation`으로 폼 제출/버튼 액션의 로딩/에러 자동 관리 (experimental)
AsyncValue	일반 클래스	`sealed class` — 패턴 매칭 시 빠뜨리면 컴파일 에러

3.0에서 가장 큰 변화는 StateNotifier가 Notifier로 대체된 것과, @riverpod 코드 제너레이션이 기본이 된 것이다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


// 2.x: 직접 선언
final todoDataProvider = StateNotifierProvider<TodoDataHolder, List<Todo>>(
 (ref) => TodoDataHolder());

class TodoDataHolder extends StateNotifier<List<Todo>> {
 TodoDataHolder() : super([]);
 // ...
}

// 3.0: @riverpod + Notifier
@riverpod
class TodoDataHolder extends _$TodoDataHolder {
 @override
 List<Todo> build() => []; // 초기 상태

 void addTodo(Todo todo) {
 state = [...state, todo];
 }
}
// build_runner가 todoDataHolderProvider 자동 생성

Mutation API는 아직 experimental이라 API가 바뀔 수 있지만, 폼 제출 같은 액션의 로딩/성공/에러 상태를 자동으로 관리해주는 기능이다. 정식 출시되면 ref.listen으로 수동 처리하던 부분이 더 간결해질 예정이다.

Ch04. 상태관리를 왜 해야 하는가 - MVC에서 선언형 UI까지

Tue, 28 Apr 2026 03:00:00 +0900

Ch04부터는 상태관리다. 왜 상태관리를 해야 하는지, 어떤 방식들이 있는지 정리한다. 개인적으로 이 부분이 꽤 재밌었다.

상태관리를 왜 해야 하나

결론부터 말하면 앱을 더 쉽게 개발하기 위해서다.

처음 개발할 때 빠르게 만들기 위해
스펙이 바뀌었을 때 수정할 곳을 빠르게 찾기 위해

작은 앱에서는 setState만으로도 충분한데, 화면이 10개 넘어가고 여러 화면에서 같은 데이터를 공유해야 하면 어디서 상태를 관리하고 어떻게 전달할지가 문제가 된다. 이걸 체계적으로 정리한 게 상태관리 패턴이다.

MVC에서 선언형 UI까지 — 왜 이렇게 바뀌었나

MVC (Model-View-Controller)

1970년대에 나온 패턴이다. 근데 많이들 오해하는 게 있다:

원래 작은 컴포넌트 단위의 설계였다. 앱 전체 아키텍처용이 아니었다.
MVVM에서 말하는 데이터 Observing이 이미 포함돼 있던 개념이다.
Controller는 원래 키보드/마우스 입력을 처리하는 역할이었다.

문제는 모바일에서 Controller의 의미가 변질됐다는 거다. Android의 Activity, iOS의 UIViewController가 이미 Controller이면서 동시에 View였다. 화면 자체가 Controller 역할을 하는 짬뽕이 된 거다. 결과적으로 Controller가 뚱뚱해지면서(Massive View Controller라고 부른다) 유지보수가 힘들어졌다.

Swift에서 UIKit 개발해본 사람이면 ViewController에 네트워크 호출, 테이블뷰 delegate, 데이터 가공 로직까지 다 때려넣어본 경험이 있을 거다. 그게 바로 MVC의 한계다.

MVP (Model-View-Presenter)

MVC의 문제를 해결하려고 나온 게 MVP다.

Android는 View가 XML로 분리돼 있었고
iOS는 View가 ViewController + Storyboard로 분리돼 있었다

이렇게 코드와 분리된 View를 제어할 Presenter가 필요했다. Presenter가 로직을 담당하고, View는 그리기만 한다.

근데 문제가 있었다. Presenter가 View에게 일일이 명령을 내려야 화면이 갱신됐다. “이 라벨 텍스트 바꿔”, “이 버튼 숨겨”, “이 리스트 리로드해”… 하나하나 다 지시해야 했다. 코드가 장황해지고 빠뜨리면 UI 버그가 났다.

MVVM (Model-View-ViewModel)

MVP의 “일일이 명령” 문제를 해결한 게 MVVM이다.

1

ViewModel의 상태를 바꾸면 → View가 알아서 갱신된다

핵심은 데이터 바인딩이다:

Android에서는 DataBinding 라이브러리가 나왔고
iOS에서는 RxSwift 같은 Rx 라이브러리로 Observable 패턴을 구현했다

값만 세팅하면 알아서 뷰가 갱신되니까 UI 버그가 확 줄었다. 근데 완벽하진 않았다. 뷰가 내부적으로 코드와 분리돼 있었기 때문에(XML, Storyboard) ViewModel과 View를 연결하는 바인딩 코드가 노가다였다.

iOS에서 RxSwift 쓸 때를 떠올리면:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


// iOS + RxSwift: 바인딩 노가다
viewModel.userName
 .bind(to: nameLabel.rx.text)
 .disposed(by: disposeBag)

viewModel.isLoading
 .bind(to: activityIndicator.rx.isAnimating)
 .disposed(by: disposeBag)

viewModel.items
 .bind(to: tableView.rx.items(cellIdentifier: "Cell")) { ... }
 .disposed(by: disposeBag)

프로퍼티 하나하나 다 바인딩해줘야 했다.

선언형 UI — 최종 보스

그리고 선언형 UI가 등장했다.

Android → Jetpack Compose
iOS → SwiftUI
크로스플랫폼 → Flutter, React

Flutter 공식 문서에서 설명하는 핵심 차이는 이거다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


// 명령형 (Imperative) — 어떻게 바꿀지 지시
button.setColor(red);
button.setText('완료');
container.removeChild(oldChild);
container.addChild(newChild);

// 선언형 (Declarative) — 어떤 상태인지 선언
return ElevatedButton(
 style: ButtonStyle(backgroundColor: MaterialStateProperty.all(Colors.red)),
 onPressed: onTap,
 child: Text('완료'),
);

명령형은 “빨간색으로 바꿔, 텍스트 바꿔, 자식 교체해” 하고 일일이 지시하는 거고, 선언형은 “이 상태일 때 UI는 이렇게 생겼다"고 선언만 하면 프레임워크가 알아서 그려준다.

SwiftUI에서 @State가 바뀌면 body가 다시 그려지는 것과 완전히 같은 원리다:

1
2
3
4
5
6
7


// SwiftUI
struct CounterView: View {
 @State var count = 0
 var body: some View {
 Button("\(count)") { count += 1 }
 }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


// Flutter
class CounterWidget extends StatefulWidget {
 @override
 State<CounterWidget> createState() => _CounterWidgetState();
}

class _CounterWidgetState extends State<CounterWidget> {
 int count = 0;

 @override
 Widget build(BuildContext context) {
 return ElevatedButton(
 onPressed: () => setState(() => count++),
 child: Text('$count'),
 );
 }
}

선언형 UI가 나오면서 View의 패턴 구조를 논의할 필요가 없어졌다. MVC냐 MVP냐 MVVM이냐가 아니라, 상태와 데이터를 어떻게 관리할지가 더 중요해진 거다. 그게 바로 State Management다.

흐름 정리

1
2
3
4
5
6
7


MVC: 원래 작은 컴포넌트용이었는데 모바일에서 Controller가 비대해짐
 ↓
MVP: View와 로직을 Presenter로 분리. 근데 일일이 명령해야 함
 ↓
MVVM: 데이터 바인딩으로 자동 갱신. 근데 바인딩 코드가 노가다
 ↓
선언형 UI: 상태만 바꾸면 끝. 이제 "상태를 어떻게 관리할까"가 핵심

Scoped Model vs Static Model

Flutter 상태관리 구조는 크게 두 가지로 나뉜다.

Scoped Model

상태의 범위를 제한하는 방식이다. 특정 화면이나 위젯 트리 안에서만 상태가 유효하다.

1
2
3
4
5


// Provider 예시: 이 위젯 하위에서만 CartModel에 접근 가능
ChangeNotifierProvider(
 create: (_) => CartModel(),
 child: ShoppingPage(), // 이 안에서만 CartModel 사용 가능
)

특징:

해당 화면이 사라지면 자동으로 메모리 해제된다
자식 위젯에서 id 없이도 상위 데이터를 참조할 수 있다
내부적으로 Flutter의 InheritedWidget을 활용한다

대표적인 Scoped 방식: Provider, BLoC, Riverpod

Static Model

상태가 전역으로 떠 있는 방식이다. 앱 어디서든 접근할 수 있다.

1
2
3
4
5
6
7
8


// GetX 예시: 어디서든 접근 가능
Get.put(UserController());

// A 화면에서
Get.find<UserController>().user.value;

// B 화면에서도
Get.find<UserController>().user.value; // 같은 인스턴스

특징:

메모리 관리를 개발자가 직접 해야 한다
자식에서 데이터 참조할 때 id(tag)가 항상 필요하다
Scoped보다 구현이 훨씬 쉽다
어디서든 접근/수정 가능하니까 상태가 꼬일 위험이 있다

대표적인 Static 방식: GetX

뭐가 다른지 예시로 보면

유튜브 앱이라고 치자. 영상 재생 화면은 코드상으로는 같은 VideoScreen인데, 어떤 영상이냐에 따라 동영상 URL, 댓글, 좋아요 수가 전부 다르다.

Scoped 방식에서는:

1
2
3
4
5


// 각 영상 화면의 상위에 해당 영상의 상태를 넣어줌
ChangeNotifierProvider(
 create: (_) => VideoState(videoId: 'abc123'),
 child: VideoScreen(), // 이 안에서는 abc123 영상의 상태만 보임
)

Riverpod에서는 family라는 기능으로 더 깔끔하게 처리한다:

1
2
3
4
5
6
7
8


// Riverpod: videoId별로 자동으로 다른 상태 인스턴스 생성
final videoProvider = FutureProvider.family<Video, String>((ref, videoId) {
 return fetchVideo(videoId);
});

// 사용: 같은 provider인데 id가 다르면 다른 상태
ref.watch(videoProvider('abc123')); // 영상 1의 상태
ref.watch(videoProvider('xyz789')); // 영상 2의 상태 (별도)

Static 방식(GetX)에서는:

1
2
3
4
5
6


// tag로 구분해서 따로 관리
Get.put(VideoController(), tag: 'abc123');
Get.put(VideoController(), tag: 'xyz789');

// 사용할 때 tag로 찾아와야 함
Get.find<VideoController>(tag: 'abc123');

둘 다 가능하다. 근데 Scoped는 화면 닫으면 알아서 정리되고, Static은 개발자가 직접 Get.delete(tag: 'abc123') 해줘야 한다.

또 다른 예시 — ID가 없는 경우

데스크탑 앱에서 “새 문서” 버튼을 3번 눌렀다고 치자. 각 문서는 아직 저장 전이라 고유 ID가 없다. 이때는 Scoped가 자연스럽다:

1
2
3
4
5
6
7


// Scoped: 각 문서 화면이 자기 스코프 안에 상태를 가짐
Navigator.push(context, MaterialPageRoute(
 builder: (_) => ChangeNotifierProvider(
 create: (_) => DocumentState(), // 각각 독립된 상태
 child: DocumentScreen(),
 ),
));

Static으로도 가능은 하다 — 임시 ID를 생성해서 tag로 관리하면 된다. 근데 굳이 그럴 필요 없이 Scoped가 더 깔끔한 케이스다.

그래서 뭘 써야 하나

정답은 스펙에 따라 다르다. 하지만 일반적인 기준은 있다:

	Scoped Model	Static Model
메모리 관리	자동 해제	직접 관리
데이터 접근	위젯 트리 통해서	어디서든 직접
구현 난이도	상대적으로 복잡	쉬움
상태 안정성	범위가 제한돼서 안전	어디서든 수정 가능해서 꼬일 수 있음
테스트	스코프 단위로 격리 가능	전역 상태라 격리 어려움
대표 패키지	Provider, BLoC, Riverpod	GetX

Swift 개발자 입장에서 비유하면:

Scoped = SwiftUI에서 @StateObject를 뷰 계층에 맞게 넣는 것
Static = 싱글톤으로 전역 접근하는 것 (AppState.shared)

iOS 개발할 때도 싱글톤 남발하면 테스트 힘들고 상태 꼬이는 걸 경험해봤을 텐데, Flutter에서도 똑같다. GetX가 쉬운 건 맞지만 앱이 커지면 Scoped 방식이 관리하기 편하다.

상태관리 패키지 현황

Flutter 공식 문서에서도 여러 접근법을 소개하고 있다. 현재 주요 패키지들의 포지션을 정리하면:

패키지	방식	특징
Provider	Scoped	Flutter 팀 추천 입문용. InheritedWidget 래퍼
BLoC	Scoped	Event → State 단방향 흐름. 엔터프라이즈 앱에 적합
Riverpod	Scoped	Provider의 진화형. 컴파일 타임 안전성. family로 키 기반 관리
GetX	Static	전역 접근, 쉬운 구현. tag로 인스턴스 구분

Flutter 공식 입장은 “setState로 시작하고, 복잡해지면 패키지를 도입하라"다. 어떤 패키지가 절대적으로 좋다기보다는 앱 규모와 팀 상황에 맞는 걸 고르는 게 맞다.

정리

상태관리의 역사를 보면 결국 한 방향으로 흘러왔다:

1

"UI를 어떻게 그릴까" → "상태를 어떻게 관리할까"

MVC에서 선언형 UI까지 오는 동안 패턴이 계속 바뀐 이유는 “상태가 바뀌면 UI가 알아서 반영되게” 하고 싶었기 때문이다. 선언형 UI가 그걸 해결했고, 이제 남은 문제는 그 상태를 어떤 범위에서 어떻게 관리할지다.

Scoped냐 Static이냐는 결국 트레이드오프다. 쉬운 걸 원하면 Static(GetX), 안전한 걸 원하면 Scoped(Provider/BLoC/Riverpod). iOS 개발할 때 싱글톤 vs 의존성 주입 고민했던 것과 본질적으로 같은 문제다.