Android动态创建布局首次正常，返回后仅显示单个ConstraintLayout

核心可能原因 #

1. Fragment视图复用/未清空旧视图：返回时Fragment的视图未被完全重建，旧布局未清空，新创建的布局叠加在旧布局上，导致视觉上只显示一个；
2. 动态布局约束失效：创建布局时未正确设置与上一个布局的垂直约束，所有ConstraintLayout都堆叠在同一位置；
3. 视图ID冲突：动态创建的ConstraintLayout未设置唯一ID，导致约束绑定出错。

具体修复步骤 #

1. 确保每次创建视图时清空旧布局

在Fragment的onCreateView或onViewCreated中，先清空父容器的所有子视图，再重新添加动态布局：

override fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    savedInstanceState: Bundle?
): View? {
    val rootView = inflater.inflate(R.layout.fragment_your_base, container, false)
    val parentContainer = rootView.findViewById<ViewGroup>(R.id.parent_container)
    
    // 关键：先清除旧视图，避免叠加
    parentContainer.removeAllViews()
    
    // 遍历数据创建布局
    constraintLayoutList.forEach { data ->
        val itemLayout = buildItemLayout(data)
        parentContainer.addView(itemLayout)
        setupItemConstraints(parentContainer, itemLayout)
    }
    return rootView
}

2. 给动态视图设置唯一ID

动态创建的ConstraintLayout及内部子视图必须设置唯一ID，否则约束会绑定失败：

private fun buildItemLayout(data: YourDataModel): ConstraintLayout {
    val itemLayout = ConstraintLayout(requireContext()).apply {
        // 生成唯一ID
        id = View.generateViewId()
        layoutParams = ConstraintLayout.LayoutParams(
            ViewGroup.LayoutParams.MATCH_PARENT,
            ViewGroup.LayoutParams.WRAP_CONTENT
        )
    }

    // 创建TextView并设置唯一ID
    val titleTv = TextView(requireContext()).apply {
        id = View.generateViewId()
        text = data.title
        textSize = 16f
    }
    itemLayout.addView(titleTv)

    // 创建RadioGroup及RadioButton
    val radioGroup = RadioGroup(requireContext()).apply {
        id = View.generateViewId()
        orientation = RadioGroup.VERTICAL
        data.options.forEach { option ->
            addView(RadioButton(requireContext()).apply {
                text = option
            })
        }
    }
    itemLayout.addView(radioGroup)

    // 设置Item内部子视图的约束
    val innerSet = ConstraintSet()
    innerSet.clone(itemLayout)
    innerSet.connect(titleTv.id, ConstraintSet.TOP, itemLayout.id, ConstraintSet.TOP, 16.dpToPx())
    innerSet.connect(titleTv.id, ConstraintSet.START, itemLayout.id, ConstraintSet.START, 16.dpToPx())
    innerSet.connect(radioGroup.id, ConstraintSet.TOP, titleTv.id, ConstraintSet.BOTTOM, 12.dpToPx())
    innerSet.connect(radioGroup.id, ConstraintSet.START, itemLayout.id, ConstraintSet.START, 16.dpToPx())
    innerSet.applyTo(itemLayout)

    return itemLayout
}

// 扩展函数：dp转px
private fun Int.dpToPx(): Int = (this * resources.displayMetrics.density).toInt()

3. 正确设置Item之间的垂直约束

确保每个动态创建的ConstraintLayout与上一个Item底部对齐，避免堆叠：

private fun setupItemConstraints(parent: ViewGroup, currentItem: ConstraintLayout) {
    val constraintSet = ConstraintSet()
    constraintSet.clone(parent)
    val childCount = parent.childCount

    if (childCount > 1) {
        // 非第一个Item，绑定到上一个Item的底部
        val previousItem = parent.getChildAt(childCount - 2)
        constraintSet.connect(
            currentItem.id,
            ConstraintSet.TOP,
            previousItem.id,
            ConstraintSet.BOTTOM,
            20.dpToPx()
        )
    } else {
        // 第一个Item，绑定到父容器顶部
        constraintSet.connect(
            currentItem.id,
            ConstraintSet.TOP,
            parent.id,
            ConstraintSet.TOP,
            20.dpToPx()
        )
    }

    // 绑定左右边距
    constraintSet.connect(
        currentItem.id,
        ConstraintSet.START,
        parent.id,
        ConstraintSet.START,
        16.dpToPx()
    )
    constraintSet.connect(
        currentItem.id,
        ConstraintSet.END,
        parent.id,
        ConstraintSet.END,
        16.dpToPx()
    )

    constraintSet.applyTo(parent)
}

4. 可选：在onResume中重新触发布局构建

如果Fragment被缓存（Navigation默认会缓存栈内Fragment），可在onResume中重新构建布局，确保数据更新后视图同步：

override fun onResume() {
    super.onResume()
    view?.findViewById<ViewGroup>(R.id.parent_container)?.let { container ->
        container.removeAllViews()
        constraintLayoutList.forEach { data ->
            val itemLayout = buildItemLayout(data)
            container.addView(itemLayout)
            setupItemConstraints(container, itemLayout)
        }
    }
}

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