targetSdk33与Kotlin1.7.20下mutableStateListOf替换元素未触发重组问题

背景说明 #

Compose重组仅在列表本身变化时触发，mutableStateListOf原本支持添加、移除或替换元素时通知重组，但升级项目版本后，调用like()方法替换列表元素不再触发重组，此前版本该逻辑正常生效。

当前项目依赖版本 #

val compilesdk = 33
val minsdk = 21
val targetsdk = 33
val kotlin = "1.7.20"
val compose_compiler = "1.4.0"
val compose_ui = "1.3.3"
val compose_runtime = "1.3.3"
val compose_foundation = "1.3.1"
val compose_material = "1.3.1"

相关代码 #

ViewModel代码 #

val recipes = mutableStateListOf<Recipe>()

fun like(index: Int, likes: ArrayList<String>) {
    recipes[index] = recipes[index].copy(likes = likes)
}

Composables代码 #

SocialNetworkContent(
      viewModel.recipes,...
)

@Composable
fun SocialNetworkContent(
    recipes: List<Recipe>,
    ...
){
..
items(
                count = recipes.size,
                itemContent = {
                    SocialListItem(
                        recipe = recipes[it],
                        it,
                        sharedPreferences,
                        viewModel,
                        onNavigateToRecipeDetailScreen,
                        onNavigateToUserProfileScreen
                    )
                },
            )
..
}

排查方向及原因分析 #

• Compose Compiler与Kotlin版本不兼容：compose_compiler 1.4.0要求搭配Kotlin 1.8.0及以上版本，当前使用的Kotlin 1.7.20版本不满足要求，版本不匹配会破坏状态更新的通知机制，导致重组不触发。这是最核心的可能原因。
• 列表参数类型丢失状态感知：SocialNetworkContent接收的参数类型为List<Recipe>，而mutableStateListOf返回的MutableStateList被当作普通List传递时，Compose可能无法正确跟踪其状态变化。建议将参数类型改为MutableStateList<Recipe>或State<List<Recipe>>。
• Lazy列表items重载的选择问题：当前使用items(count = recipes.size)的重载，Compose仅会跟踪列表长度变化，无法感知单个元素的替换。改用items(recipes)直接传入列表的重载，Compose会通过元素的equals比较感知变化，触发对应项的重组。
• Recipe类的equals实现异常：如果Recipe不是数据类，或自定义的equals方法导致copy后的对象与原对象相等，Compose会判定元素未变化，不触发重组。确认Recipe是数据类，且likes字段的修改会改变equals结果。

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