2nd/10_Wiki/Topics/Coding/Android_Flow_StateFlow_SharedFlow.md

id, title, category, status, source_trust_level, verification_status, created_at, updated_at, tags, tech_stack, applied_in, aliases

id	title	category	status	source_trust_level	verification_status	created_at	updated_at	tags	tech_stack	applied_in	aliases
android-flow-stateflow-sharedflow	Flow / StateFlow / SharedFlow — 어떤 걸 언제	Coding	draft	B	conceptual	2026-05-09	2026-05-09	android kotlin flow vibe-coding	language applicable_to Kotlin Coroutines Android Server		cold flow hot flow replay state vs event

Flow / StateFlow / SharedFlow

셋 다 비동기 stream 이지만 의미 다름: Flow = 1회성 cold, StateFlow = 현재 상태 (hot, 1 replay), SharedFlow = 이벤트 버스 (hot, configurable replay). 잘못 고르면 이벤트 손실 또는 중복 emit.

📖 핵심 개념

• Cold flow: collect 시작할 때 producer 시작. collector 0 = 비활성. 각 collector 별 독립.
• Hot flow: producer 가 계속 동작. collector 수와 무관. 다수 collector 공유.
• StateFlow: 현재 값 보유. 새 collector → 즉시 현재 값 받음. distinctUntilChanged 자동.
• SharedFlow: 이벤트 list. replay 옵션 (새 collector 가 받을 옛 emission 수).

💻 코드 패턴

Flow — DB / network result

fun getUser(id: String): Flow<User> = flow {
    val u = api.fetch(id)
    emit(u)
}

StateFlow — UI state

class ViewModel : ViewModel() {
    private val _state = MutableStateFlow(UiState.Idle)
    val state: StateFlow<UiState> = _state.asStateFlow()

    fun load() {
        viewModelScope.launch {
            _state.value = UiState.Loading
            // ...
        }
    }
}

SharedFlow — 일회성 이벤트

private val _events = MutableSharedFlow<Event>(replay = 0, extraBufferCapacity = 1)
val events: SharedFlow<Event> = _events.asSharedFlow()

fun showError(msg: String) {
    _events.tryEmit(Event.Error(msg))
}

stateIn — Flow → StateFlow 변환

val state: StateFlow<UiState> = repo.observeUser(id)
    .map { UiState.Success(it) }
    .stateIn(
        scope = viewModelScope,
        started = SharingStarted.WhileSubscribed(5000), // 5s 후 unsubscribe
        initialValue = UiState.Loading,
    )

combine, flatMapLatest, debounce

val results = combine(query.debounce(300), filters) { q, f -> q to f }
    .flatMapLatest { (q, f) -> repo.search(q, f) }
    .stateIn(viewModelScope, SharingStarted.WhileSubscribed(5000), emptyList())

🤔 의사결정 기준

데이터	권장
1회성 fetch (사용자 정보, network call)	Flow
UI 가 항상 봐야 할 현재 state	StateFlow
Snackbar / Navigation 같은 일회성 이벤트	SharedFlow (replay=0)
다수 구독자 + buffered	SharedFlow + replay/buffer
Database (Room flow)	Flow → stateIn
화면 회전 시 이벤트 재실행 막기	SharedFlow + STARTED 만 collect

❌ 안티패턴

• 이벤트 (Snackbar) 를 StateFlow 로: state 라 회전 시 재실행. SharedFlow + replay=0.
• state 를 SharedFlow 로: 새 collector 가 옛 값 못 받음 (replay=0). StateFlow 가 맞음.
• stateIn 없이 cold flow 를 UI 에서 collect: 회전 시 새 collect = 새 fetch. stateIn(WhileSubscribed) 권장.
• collectLatest 대신 collect (검색 같은 케이스): 이전 결과가 늦게 도착해 새 결과 덮어씀. flatMapLatest / collectLatest.
• MutableStateFlow 를 외부 노출: 외부 mutate 가능. asStateFlow().
• emit 대신 tryEmit 인데 buffer 0: drop. 버퍼 또는 emit (suspend).

🤖 LLM 활용 힌트

• "현재 상태 = StateFlow, 일회성 이벤트 = SharedFlow(replay=0), Room/network = Flow + stateIn" 명시.
• WhileSubscribed(5000) 이 표준.

🔗 관련 문서

• Android_Kotlin_Coroutines_Scopes
• Android_ViewModel_State_Persistence