Fragment替换切换时XML内嵌Compose组件未正常重绘如何解决？

在Fragment加载的自定义视图XML中嵌入Compose组件，项目采用Navigation导航组件实现页面跳转。存在如下异常：

• 从当前Fragment导航离开再返回时，XML内除Compose组件外的其余UI均可正常恢复
• Fragment触发替换、整页UI重绘时，嵌入的Compose组件未正常加载
• 通过Layout Inspector检查可见，异常场景下ComposeView节点始终存在于视图树中，更换不同ViewCompositionStrategy配置后问题仍未解决

XML中ComposeView声明 #

<androidx.compose.ui.platform.ComposeView
    android:id="@+id/expando_link_compose"
    android:visibility="gone"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:layout_constraintTop_toBottomOf="@+id/subheading"
    app:layout_constraintStart_toStartOf="@+id/heading"
/>

初始化代码 #

findViewById<ComposeView>(R.id.expando_link_compose).apply {
    visibility = VISIBLE
    setViewCompositionStrategy(ViewCompositionStrategy.DisposeOnViewTreeLifecycleDestroyed)
    setContent {
        AppTheme {
            SurfaceView(....)
        }
    }
}

• 修正初始化调用时机
  不要把ComposeView的初始化逻辑放在onCreate、懒加载委托等仅首次创建Fragment时执行的代码块中。Fragment从返回栈恢复时会重建视图层级，必须在onViewCreated生命周期回调中，针对当前新创建的视图实例执行findViewById和setContent操作，避免持有上一个视图生命周期中已失效的ComposeView引用。

• 主动清理失效Composition
  由于ComposeView初始状态设置为gone，视图复用时可能残留已终止的Composition上下文导致内容不渲染，初始化前先主动清理旧Composition，参考实现：

  override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
      super.onViewCreated(view, savedInstanceState)
      view.findViewById<ComposeView>(R.id.expando_link_compose).apply {
          disposeComposition() // 清理旧的失效Composition
          visibility = VISIBLE
          setViewCompositionStrategy(ViewCompositionStrategy.DisposeOnViewTreeLifecycleDestroyed)
          setContent {
              AppTheme {
                  SurfaceView(/* 业务参数 */)
              }
          }
      }
  }
  

• 排查布局测量异常
  由于ComposeView宽高设置为wrap_content，Fragment返回时上层ConstraintLayout可能未触发重新测量，导致Compose内容测量宽高为0，视觉上呈现未加载状态。可临时将ComposeView宽高改为固定值测试，如果固定值下能正常显示，在Fragment的onResume回调中对ComposeView调用requestLayout()触发重新测量即可。

• 检查自定义组件生命周期
  如果代码中的SurfaceView是继承自传统Android View的自定义组件，而非Compose组件，需要确认其SurfaceHolder.Callback是否在视图重新挂载时正确注册，避免一次性注册回调后视图复用时不触发绘制逻辑。

• 校验上下文引用有效性
  setContent内部的AppTheme、自定义组件不要引用Fragment上一轮生命周期中已销毁的Context对象，统一使用ComposeView自身携带的Context，避免上下文失效导致渲染异常。

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