如何防止LaunchedEffect在配置变更时重复执行，实现仅在Composable首次加载时运行一次

这个问题我之前也碰到过，确实挺恼人的——本来想让代码只跑一次，结果屏幕一转又重复执行了。咱们先来理清楚为什么会这样：当发生屏幕旋转这类配置变更时，你的Activity/Fragment会被销毁重建，对应的Composable也会重新初始化，哪怕你用了LaunchedEffect(true)，也会因为Composable的重新创建而再次触发执行。

下面给你几个靠谱的解决方案，按需选择：

方案一：用rememberSaveable标记执行状态 #

这个方法适合轻量场景，直接在Composable内部通过可持久化的状态来控制是否执行代码：

@Composable
fun MyScreen() {
    // rememberSaveable会在配置变更时保留状态，不会重置
    val hasExecutedApiCall = rememberSaveable { mutableStateOf(false) }

    LaunchedEffect(Unit) {
        if (!hasExecutedApiCall.value) {
            // 这里放你的API请求逻辑
            println("执行API请求")
            hasExecutedApiCall.value = true
        }
    }

    // 其他Composable内容
}

核心逻辑是用rememberSaveable保存一个布尔标记，只有当标记为false时才执行API调用，执行后把标记设为true。因为rememberSaveable会将状态持久化到Bundle中，配置变更后不会丢失，所以只会触发一次。

方案二：将API调用移到ViewModel中 #

这是更推荐的架构级方案，因为ViewModel在配置变更时不会被销毁，天生适合处理这类需要跨越配置变更的业务逻辑：

class MyViewModel : ViewModel() {
    init {
        // 在ViewModel的初始化块里发起API请求，只会执行一次
        viewModelScope.launch {
            // 这里放你的API请求逻辑
            println("执行API请求")
        }
    }
}

// 在Composable中使用
@Composable
fun MyScreen() {
    val viewModel: MyViewModel = viewModel()
    // 其他Composable内容
}

把API请求放在ViewModel的init块里，ViewModel只会在首次创建时初始化，配置变更时会复用同一个实例，所以代码只会执行一次。这种方式也符合MVVM的架构设计，把业务逻辑从UI层剥离出来，更易维护。

方案三：结合DisposableEffect和LocalContext（进阶用法） #

如果你需要更精细的生命周期控制，比如整个应用生命周期内只执行一次，可以用DisposableEffect结合应用级Context来实现：

@Composable
fun MyScreen() {
    val appContext = LocalContext.current.applicationContext
    val isFirstRun = remember {
        // 用SharedPreferences记录是否首次执行
        val prefs = appContext.getSharedPreferences("MyPrefs", Context.MODE_PRIVATE)
        val firstRun = prefs.getBoolean("first_run", true)
        if (firstRun) {
            prefs.edit().putBoolean("first_run", false).apply()
        }
        firstRun
    }

    LaunchedEffect(isFirstRun) {
        if (isFirstRun) {
            // 执行API请求
            println("执行API请求")
        }
    }
}

这个方法利用SharedPreferences持久化标记，哪怕应用重启也只会执行一次，适合全局唯一的初始化逻辑。

内容的提问来源于stack exchange，提问作者Abhinav