使用FragmentContainerView初始启动不显示Fragment问题求助

以下是针对该问题的排查和解决步骤：

• 检查Activity继承关系
  确保承载Fragment的Activity继承自AppCompatActivity或FragmentActivity，普通Activity不支持AndroidX Fragment体系，会导致布局中指定的Fragment无法被正确实例化加载。

• 移除Activity中多余的Fragment替换代码
  如果你的Activity的onCreate方法里存在类似如下的代码，会覆盖布局中通过android:name指定的Fragment，导致启动时空白：

  supportFragmentManager.beginTransaction()
      .replace(R.id.fragment_container_content, OtherFragment())
      .commit()
  

  启动时不需要手动替换，布局中的android:name会自动加载对应的Fragment。

• 确保Fragment有公共无参构造
  RunningFragment必须提供公共的无参构造方法，系统通过android:name实例化Fragment时会调用这个构造。如果只有带参数的构造，会导致实例化失败，且可能无报错提示。

• 验证Fragment的onCreateView实现
  检查RunningFragment的onCreateView方法是否正确返回了布局视图，示例如下：

  override fun onCreateView(
      inflater: LayoutInflater,
      container: ViewGroup?,
      savedInstanceState: Bundle?
  ): View? {
      // 确保正确填充fragment_running布局
      return inflater.inflate(R.layout.fragment_running, container, false)
  }
  

  如果返回null，Fragment会显示空白。

• 避免重复添加Fragment（状态恢复处理）
  如果Activity中手动添加Fragment，要判断savedInstanceState是否为null，避免在屏幕旋转等状态恢复场景重复添加：

  override fun onCreate(savedInstanceState: Bundle?) {
      super.onCreate(savedInstanceState)
      setContentView(R.layout.activity_main)
      
      // 仅在首次创建时添加，状态恢复时系统会自动恢复Fragment
      if (savedInstanceState == null) {
          // 如果你选择手动添加而非布局指定，可在此执行，但需移除布局中的android:name
          // supportFragmentManager.beginTransaction()
          //     .add(R.id.fragment_container_content, RunningFragment())
          //     .commit()
      }
  }
  

• 清理项目缓存
  尝试执行Build -> Clean Project，再执行Build -> Rebuild Project，清除Android Studio的缓存，避免布局与代码不同步导致的问题。

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