二次旋转后Fragment未附着报错：横竖屏切换布局适配问题求助

这个问题我之前也碰到过，核心原因是横竖屏切换触发Activity重建时，Fragment的实例状态和我们手动创建的实例发生了冲突，导致代码操作了还未Attach到Activity的Fragment实例。下面给你几个针对性的解决办法：

1. 优先复用系统恢复的Fragment实例（最推荐） #

当横竖屏切换时，系统会自动保存并恢复布局中嵌入的Fragment实例。所以不要每次切横屏都new新的Fragment，而是先通过FragmentManager查找已存在的实例，找不到再创建：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    if (getResources().getConfiguration().orientation == Configuration.ORIENTATION_LANDSCAPE) {
        // 横屏时先查找已存在的Fragment，避免重复创建
        Fragment fragmentA = getSupportFragmentManager().findFragmentById(R.id.fragment_a_container);
        Fragment fragmentB = getSupportFragmentManager().findFragmentById(R.id.fragment_b_container);

        if (fragmentA == null) {
            fragmentA = new FragmentA();
            getSupportFragmentManager().beginTransaction()
                .add(R.id.fragment_a_container, fragmentA)
                .commitNow(); // 用commitNow确保Fragment立即Attach，避免后续操作报错
        }

        if (fragmentB == null) {
            fragmentB = new FragmentB();
            getSupportFragmentManager().beginTransaction()
                .add(R.id.fragment_b_container, fragmentB)
                .commitNow();
        }
    } else {
        // 竖屏ViewPager逻辑：复用已有的Adapter，避免重复创建Fragment
        ViewPager viewPager = findViewById(R.id.view_pager);
        if (viewPager.getAdapter() == null) {
            viewPager.setAdapter(new MyPagerAdapter(getSupportFragmentManager(), getLifecycle()));
        }
    }
}

这里用commitNow替代普通的commit，能确保Fragment立即完成Attach流程，避免后续操作时还处于未Attach状态。

2. 确保Fragment内的操作在Attach后执行 #

报错Fragment has not been attached yet大多是因为在Fragment还未绑定Activity时，就调用了getActivity()、requireContext()这类依赖Activity的方法。把这类操作移到onViewCreated或onAttach之后的生命周期方法：

@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
    super.onViewCreated(view, savedInstanceState);
    // 在这里执行需要Context/Activity的操作，比如初始化View、调用ViewModel
    initView(view);
    loadData();
}

如果一定要在更早的阶段执行，可以先判断Fragment是否已Attach：

if (isAdded()) {
    // 执行依赖Activity的操作
}

3. 临时方案：禁止Activity重建（不推荐） #

如果你的应用逻辑简单，可以在AndroidManifest.xml中给MainActivity添加配置，避免横竖屏切换时重建Activity：

<activity
    android:name=".MainActivity"
    android:configChanges="orientation|screenSize|smallestScreenSize">
</activity>

然后在Activity中重写onConfigurationChanged处理切换逻辑：

@Override
public void onConfigurationChanged(@NonNull Configuration newConfig) {
    super.onConfigurationChanged(newConfig);
    setContentView(R.layout.activity_main);
    // 根据新的配置重新初始化UI
    if (newConfig.orientation == Configuration.ORIENTATION_LANDSCAPE) {
        initLandscapeLayout();
    } else {
        initPortraitLayout();
    }
}

⚠️ 注意：这个方法会跳过系统的状态保存机制，可能导致其他组件状态丢失，仅作为应急方案使用。

4. 检查ViewPager Adapter的复用逻辑 #

竖屏模式下的ViewPager，如果使用FragmentPagerAdapter或FragmentStateAdapter，要确保Adapter只初始化一次，避免重建时重复创建Fragment实例：

private MyPagerAdapter pagerAdapter;

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);

    if (getResources().getConfiguration().orientation == Configuration.ORIENTATION_PORTRAIT) {
        ViewPager viewPager = findViewById(R.id.view_pager);
        if (pagerAdapter == null) {
            pagerAdapter = new MyPagerAdapter(getSupportFragmentManager(), getLifecycle());
        }
        viewPager.setAdapter(pagerAdapter);
    }
}

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