原生移动开发 / 系统课时

排查 Compose 重组过多

排查 Compose 重组过多

Compose 卡顿不等于“重组次数多”,真正的问题通常是状态读取过早、重组范围过大、参数稳定性不足,或重组时重复执行了昂贵计算。本文用一个可观察的日志示例建立排查方法,再把问题收敛到状态读取位置、参数设计和计算缓存三个层面。

学习目标

  • 能区分“发生重组”和“发生了不必要的重组”
  • 能定位状态读取造成的重组范围扩大问题
  • 能使用稳定参数与 remember 等机制减少重复工作

先看谁在因为状态变化而重组

Compose 会根据状态读取建立重组关联:某个可组合函数读取的状态发生变化时,相关作用域可能重新执行。因此排查时首先要找“谁读取了变化频繁的状态”,而不是看到界面刷新就直接优化。

例如滚动位置、计时器、动画值等状态变化频率很高。若顶层页面直接读取这些值,再把结果传给大片子树,即使大部分子组件与该状态无关,也可能扩大重组影响范围。

Compose 状态读取与重组范围关系

先给关键可组合函数加入可观察日志。下面是片段示例,依赖 AndroidX Compose 与当前 Activity 环境,用于观察某个子组件在状态变化时是否反复执行。

kotlin
import android.util.Log
import androidx.compose.foundation.layout.Column
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.SideEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue

@Composable
fun CounterScreen() {
    var count by remember { mutableStateOf(0) }

    Column {
        Text("count=$count")
        StableRow(title = "固定标题")
    }
}

@Composable
private fun StableRow(title: String) {
    SideEffect {
        Log.d("ComposePerf", "StableRow recomposed: $title")
    }
    Text(title)
}

预期结果

text
Logcat 中可以观察到 ComposePerf 标签的重组日志;当与 StableRow 无关的状态变化发生时,应重点检查该日志是否仍持续增加。

缩小状态读取范围

一个实用原则是:尽量在真正需要该状态的地方读取它。例如滚动列表的偏移量只影响顶部悬浮控件,就不要先在整个页面读取后再把结果层层传递给所有内容组件。

另一个常见问题是,把高频变化状态转换成普通值后传入大范围子树。这样虽然代码更直观,却让状态影响范围变得隐蔽。排查时可以从状态声明向下追踪,记录“读取点 → 计算点 → 参数传递 → UI 影响范围”。

需要注意,缩小重组范围不是为了追求“零重组”。用户操作本身就需要界面更新。真正应该减少的是与当前变化无关的重组,以及重组期间重复执行的昂贵工作。

检查参数稳定性与重复计算

当父组件重组时,子组件能否跳过无关执行,与传入参数是否稳定有关。优先传递简单、稳定且语义清晰的数据,避免为了方便把不断新建的对象、临时集合或带复杂可变状态的结构一路向下传递。

计算型问题则要单独判断。只要计算结果只依赖少量稳定输入,就可以考虑用 remember 缓存;如果结果依赖某个状态,则把正确的依赖放进 remember 的键中。不要为了“减少重组”把所有内容都包进 remember,因为错误缓存可能让界面读取到过期结果。

kotlin
@Composable
fun PriceSummary(price: Int, discount: Int) {
    val finalPrice = remember(price, discount) {
        (price - discount).coerceAtLeast(0)
    }

    Text(text = "最终价格:$finalPrice")
}

预期结果

text
当 price 或 discount 不变时,finalPrice 不会因为 PriceSummary 的其他无关重组而重新执行计算;任一输入变化后会重新计算并显示新结果。

用一次修改验证是否有效

实际排查可以按“状态读取位置 → 参数稳定性 → 重复计算”顺序进行。先记录问题组件,再只改变一个因素,例如把高频状态的读取点下移;随后用相同操作重新观察日志和滑动体验。

当重组次数下降但卡顿没有改善时,不要继续围绕重组次数做微调。此时应检查重组中的计算、图片处理、布局或绘制成本。Compose 性能优化的目标不是让每个组件尽可能少重组,而是让状态变化只影响必要的 UI,并让每次必要重组都足够轻。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

排查 Compose 重组过多

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通