FragmentContainerView固定左上角且报未知片段错误的求助

问题现象 #

拖拽FragmentContainerView到设计视图并关联Fragment后，能正常调整大小、设置约束，但随后出现"unknown fragments"错误提示；手动指定布局后，容器会跳到左上角，添加约束、修改XML约束均无效。

可行解决步骤 #

• 校验tools:layout引用：确认tools:layout="@layout/fragment_blank"指向的布局文件真实存在，路径无拼写错误。可以先删除该属性，再在设计视图中重新关联Fragment布局，让Android Studio自动生成正确引用。
• 清除IDE缓存：打开Android Studio的File菜单，选择Invalidate Caches...，勾选Invalidate and Restart重启IDE。缓存异常是布局预览问题的常见诱因。
• 检查Fragment类路径：确认android:name="com.example.test1.BlankFragment"中的类路径完全正确，BlankFragment类确实存在于com.example.test1包下，类名无大小写错误。
• 重构约束与尺寸设置：确保FragmentContainerView的约束无冲突，以下是调整后的XML示例，固定尺寸同时保留四边约束，避免布局偏移：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/main"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/textView"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="Hello World!"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintHorizontal_bias="0.464"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintVertical_bias="0.116" />

    <Button
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_marginTop="492dp"
        android:layout_marginEnd="180dp"
        android:text="Button"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintTop_toTopOf="parent" />

    <androidx.fragment.app.FragmentContainerView
        android:id="@+id/fragmentContainerView3"
        android:name="com.example.test1.BlankFragment"
        android:layout_width="120dp"
        android:layout_height="143dp"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintTop_toTopOf="parent"
        tools:layout="@layout/fragment_blank" />

</androidx.constraintlayout.widget.ConstraintLayout>

注：如果需要让容器自适应尺寸，可将layout_width和layout_height改为0dp（match_constraint），配合约束实现填充或比例布局。

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