Kotlin Flow 实战：StateFlow 和 SharedFlow 的默认值陷阱

在 Android 开发中，Kotlin 的 StateFlow 和 SharedFlow 是两种常用的数据流，但它们的行为有时会让开发者感到困惑。比如：

"为什么我还没更新 StateFlow，collect 就被触发了？"
"SharedFlow 为什么不会自动发射初始值？"

这篇文章将深入探讨它们的区别，并用一个 "用户选择文件路径" 的案例来演示如何正确使用它们。

1. StateFlow 和 SharedFlow 的区别

特性	`StateFlow`	`SharedFlow`
初始值	✅ 必须提供（`MutableStateFlow(initialValue)`）	❌ 无初始值
缓存最新值	✅ 新订阅者会立即收到最新值	❌ 默认不缓存（可配置 `replay`）
冷流/热流	热流（始终活跃）	热流（需手动 `emit`）
适用场景	UI 状态管理（如 `LiveData` 替代）	事件流（如按钮点击、一次性通知）

2. 问题复现：StateFlow 的初始值陷阱

假设我们有一个 文件选择器，用户选择路径后，我们读取文件内容并显示。

❌ 问题代码（StateFlow 自动触发初始值）

kotlin 复制代码

class FileViewModel : ViewModel() {
    private val _filePath = MutableStateFlow("") // 初始值 = ""
    val filePath: StateFlow<String> = _filePath

    fun updatePath(path: String) {
        _filePath.value = path
    }

    init {
        viewModelScope.launch {
            filePath.collect { path ->
                loadFileContent(path)  // 加载文件
            }
        }
    }

    private fun loadFileContent(path: String) {
        println("加载文件: $path")  // 但初始值 "" 仍然触发了 collect！
    }
}

问题：即使 updatePath 还没调用，loadFileContent 仍然会被 "" 触发一次！

✅ 解决方案 1：改用 SharedFlow（无初始值）

kotlin 复制代码

class FileViewModel : ViewModel() {
    private val _filePath = MutableSharedFlow<String>()
    val filePath: SharedFlow<String> = _filePath

    fun updatePath(path: String) {
        viewModelScope.launch {
            _filePath.emit(path)  // 手动发射
        }
    }

    init {
        viewModelScope.launch {
            filePath.collect { path ->  // 只有 emit 后才会触发
                loadFileContent(path)
            }
        }
    }
}

优点：collect 只会在 emit 后触发，避免初始值问题。

✅ 解决方案 2：StateFlow + 过滤初始值

如果仍想用 StateFlow，可以用 filter 或 drop 跳过初始值：

kotlin 复制代码

init {
    viewModelScope.launch {
        filePath
            .filter { it.isNotEmpty() }  // 跳过 ""
            .collect { path ->
                loadFileContent(path)
            }
    }
}

3. 在 Jetpack Compose 中使用

StateFlow（需初始值）

kotlin 复制代码

@Composable
fun FileScreen(viewModel: FileViewModel) {
    val path by viewModel.filePath.collectAsState()  // 自动接收初始值 ""
    Text("当前路径: $path")
}

SharedFlow（需手动给初始值）

kotlin 复制代码

@Composable
fun FileScreen(viewModel: FileViewModel) {
    val path by viewModel.filePath
        .collectAsState(initial = "")  // 必须提供初始值
    Text("当前路径: $path")
}

4. 如何选择？

场景	推荐
UI 状态管理（如页面数据加载、表单状态）	`StateFlow`（自动缓存最新值）
事件流（如按钮点击、导航事件）	`SharedFlow`（避免初始值干扰）
需要严格避免初始值触发	`SharedFlow` + `filter`/`drop`

5. 总结

StateFlow 会立即发射初始值 ，适合 UI 状态管理（类似 LiveData）。
SharedFlow 不会自动发射初始值，适合事件流（如用户操作）。
在 Compose 中，collectAsState 必须提供初始值，否则会报错。

通过这个案例，你应该能更清楚地选择 StateFlow 或 SharedFlow，避免因初始值导致意外行为。

🚀 最佳实践：

UI 状态 → StateFlow
事件流 → SharedFlow
想跳过初始值 → filter/drop