如何用Single<List<Feature>>结果填充Jetpack Compose LazyColumn？排查无显示问题

我正在维护别人的旧代码，现在遇到个问题：怎么用下面的代码把Single<List<Feature>>的结果填充到Jetpack Compose的LazyColumn里，让每个列表项显示标题和描述？目前LazyColumn啥都不显示，featureConfigs = listOf<Feature>()也没被填充，不知道问题出在哪。

ViewModel类 #

class FeatureConfigViewModel @Inject constructor(
private val featuresRepository: FeaturesRepository,
private val localFeatureConfigOverrider: LocalFeatureConfigOverrider): ViewModel() {

var featureConfigs = listOf<Feature>()
@Inject lateinit var featureConfig: FeatureConfig


init {
    if (
        JSON_FEATURE_FLAG_DATA_KEY.isNotEmpty()
    ) {
        val jsonData = JSON_FEATURE_FLAG_DATA_KEY
        loadFeatures(jsonData)
    } else {
        loadFeatures()
    }
}


fun loadFeatures() {
    loadFeatures(featuresRepository.getFeatures(JSON_FILE_NAME))
}

fun loadFeatures(jsonData: String) {
    loadFeatures(
        featuresRepository.getFeatures(JSON_FILE_NAME)
            .zipWith(
                featuresRepository.getFeaturesFromJson(jsonData)
            ) { featuresFromFile, featuresFromJson ->
                for (feature in featuresFromFile) {
                    val overrideValue = featuresFromJson[feature.key]
                    if (overrideValue != null) {
                        localFeatureConfigOverrider.put(feature.key, overrideValue)
                    }
                }
                featuresFromFile
            }
    )
}

private fun loadFeatures(featuresSingle: Single<List<Feature>>) {
    val d = featuresSingle.subscribe({ featureList ->
        val features = featureList.toMutableList().sortedBy { it.key }
        featureConfigs = features
    }) { throwable ->
        Logger.e(throwable)
    }
}

companion object {
    private const val JSON_FILE_NAME = "fileName.json"
    const val JSON_FEATURE_FLAG_DATA_KEY = "keyName"
}
}

包含LazyColumn的View代码片段 #

LazyColumn(modifier = Modifier
                .weight(weight = 1f, fill = false)
                .fillMaxSize()) {
                items(items = configs) {
                    LazyColumnDescription(
                        name = it.key,
                        description = it.description,
                    )
                }
            }

问题分析与修复方案 #

核心问题 #

1. featureConfigs是普通变量，Compose无法感知其变化，就算赋值成功UI也不会触发重组更新。
2. RxJava的Single订阅未指定线程调度，可能导致回调在非主线程执行，或者订阅未正常触发。
3. View层的configs未正确关联ViewModel的数据源，数据传递链路断裂。

修复步骤 #

1. 改造ViewModel，让数据可被Compose感知

把普通变量替换为MutableStateFlow，这是Jetpack生态中推荐的可观察状态容器：

class FeatureConfigViewModel @Inject constructor(
    private val featuresRepository: FeaturesRepository,
    private val localFeatureConfigOverrider: LocalFeatureConfigOverrider
): ViewModel() {
    // 替换普通变量为StateFlow，外部只能只读访问
    private val _featureConfigs = MutableStateFlow(listOf<Feature>())
    val featureConfigs = _featureConfigs.asStateFlow()

    @Inject lateinit var featureConfig: FeatureConfig

    init {
        if (JSON_FEATURE_FLAG_DATA_KEY.isNotEmpty()) {
            val jsonData = JSON_FEATURE_FLAG_DATA_KEY
            loadFeatures(jsonData)
        } else {
            loadFeatures()
        }
    }

    // 其他方法不变，仅修改订阅回调部分
    private fun loadFeatures(featuresSingle: Single<List<Feature>>) {
        featuresSingle
            .subscribeOn(Schedulers.io()) // 指定IO线程执行文件/网络操作
            .observeOn(AndroidSchedulers.mainThread()) // 切回主线程更新状态
            .subscribe({ featureList ->
                val features = featureList.sortedBy { it.key }
                _featureConfigs.value = features // 更新StateFlow的值，触发UI重组
            }) { throwable ->
                Logger.e(throwable)
            }.let { disposable ->
                // 用viewModelScope管理订阅生命周期，防止内存泄漏
                viewModelScope.launch {
                    awaitDispose { disposable.dispose() }
                }
            }
    }

    companion object {
        private const val JSON_FILE_NAME = "fileName.json"
        const val JSON_FEATURE_FLAG_DATA_KEY = "keyName"
    }
}

2. 改造Compose View，正确收集数据

在View中用生命周期感知的方式收集StateFlow的数据，确保UI能响应变化：

// 获取ViewModel实例（根据项目依赖用hilt或viewModel()方法）
val viewModel: FeatureConfigViewModel = viewModel()
// 收集StateFlow数据，自动感知生命周期
val configs by viewModel.featureConfigs.collectAsStateWithLifecycle()

LazyColumn(modifier = Modifier
    .weight(1f, fill = false)
    .fillMaxSize()) {
    items(items = configs) { feature ->
        LazyColumnDescription(
            name = feature.key,
            description = feature.description,
        )
    }
}

3. 排查订阅是否正常触发

• 在loadFeatures的成功回调中添加日志，确认是否拿到了数据：

  .subscribe({ featureList ->
      Logger.d("加载到Feature数量：${featureList.size}")
      val features = featureList.sortedBy { it.key }
      _featureConfigs.value = features
  }) { throwable ->
      Logger.e(throwable, "加载Feature失败")
  }
  

• 检查featuresRepository.getFeatures是否返回了有效的Single，比如JSON文件是否存在、解析逻辑是否正确。

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