Jetpack Compose可组合函数在主类外部无法正常工作

问题根源 #

你当前的实现是在Activity协程中直接收集Flow，每次收到事件就调用setContent重新创建BottomSheet的Composable。这种方式在Composable属于Activity内部函数时能正常运行，但移到外部后，由于Composition的生命周期与Activity的绑定逻辑变化，导致Sheet的显示逻辑失效。

解决方案 #

1. 优化Flow状态收集逻辑（推荐方案） #

将Flow的收集移到Composable内部，使用Compose内置的collectAsState()观察状态变化，让Compose自动处理重组，避免手动重复调用setContent。

步骤1：更新ViewModel的状态管理

确保ViewModel使用StateFlow管理BottomSheet的显示状态：

class MainActivityViewModel : ViewModel() {
    private val _showBottomSheet = MutableStateFlow(false)
    val showBottomSheet = _showBottomSheet.asStateFlow()

    fun toggleBottomSheet(show: Boolean) {
        _showBottomSheet.value = show
    }
}

步骤2：重构Activity的ComposeView初始化

只需要一次调用setContent，在Composable内部处理状态变化：

class MainActivity : AppCompatActivity() {
    private val binding by lazy { ActivityMainBinding.inflate(layoutInflater) }
    private val viewModel by viewModels<MainActivityViewModel>()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(binding.root)

        binding.buttonComposeView.setContent {
            ButtonViewContent(viewModel)
        }

        binding.bottomSheetComposeView.setContent {
            val showBottomSheet by viewModel.showBottomSheet.collectAsState()
            if (showBottomSheet) {
                ModalBottomSheetSample(onDismiss = {
                    viewModel.toggleBottomSheet(false)
                })
            }
        }
    }
}

步骤3：调整外部Composable函数

将ViewModel作为参数传入需要访问它的Composable，使用LaunchedEffect替代SideEffect触发Sheet显示（LaunchedEffect更适配协程逻辑，且仅在首次组合时执行）：

@Composable
fun ButtonViewContent(viewModel: MainActivityViewModel) {
    val scope = rememberCoroutineScope()
    Column(Modifier.fillMaxSize()) {
        Button(
            onClick = {
                scope.launch {
                    viewModel.toggleBottomSheet(true)
                }
            }
        ) {
            Text(text = "Open Bottom Sheet")
        }
    }
}

@Composable
@OptIn(ExperimentalMaterialApi::class)
fun ModalBottomSheetSample(onDismiss: () -> Unit) {
    val sheetState = rememberModalBottomSheetState(
        initialValue = ModalBottomSheetValue.Hidden,
        skipHalfExpanded = true
    )
    val scope = rememberCoroutineScope()

    // 首次组合时触发BottomSheet显示
    LaunchedEffect(Unit) {
        sheetState.show()
    }

    // 监听Sheet状态，隐藏时回调关闭逻辑
    LaunchedEffect(sheetState.currentValue) {
        if (sheetState.currentValue == ModalBottomSheetValue.Hidden) {
            onDismiss()
        }
    }

    ModalBottomSheetLayout(
        sheetState = sheetState,
        sheetContent = {
            LazyColumn {
                items(5) {
                    ListItem(
                        icon = {
                            Icon(
                                Icons.Default.Favorite,
                                contentDescription = null
                            )
                        },
                        text = { Text("Item $it") },
                    )
                }
            }
        }
    ) {}
}

@OptIn(ExperimentalMaterialApi::class)
@Composable
fun ModalBottomSheetContent(sheetState: ModalBottomSheetState) {
    ModalBottomSheetLayout(
        sheetState = sheetState,
        sheetContent = {
            LazyColumn {
                items(5) {
                    ListItem(
                        icon = {
                            Icon(
                                Icons.Default.Favorite,
                                contentDescription = null
                            )
                        },
                        text = { Text("Item $it") },
                    )
                }
            }
        }
    ) {}
}

2. 确保Experimental API的Opt-In配置正确 #

如果遇到编译错误，检查模块build.gradle是否全局开启了Experimental Material API的Opt-In：

android {
    kotlinOptions {
        freeCompilerArgs += [
            "-opt-in=androidx.compose.material.ExperimentalMaterialApi"
        ]
    }
}

配置后无需在每个Composable函数上单独添加@OptIn注解。

失效原因分析 #

当Composable在Activity内部时，其Composition与Activity生命周期绑定更紧密，手动调用setContent能稳定触发Sheet显示逻辑。但移到外部后，每次setContent都会创建全新的Composition，SideEffect的执行时机可能与Activity生命周期不同步，导致Sheet显示逻辑无法正确执行。使用Compose内置的状态收集机制，能确保状态变化与Composition生命周期对齐，彻底避免这类问题。

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