屏幕旋转后Fragment中的RecyclerView无法加载问题排查求助

我帮你找到了代码里的几个关键错误，这就是导致屏幕旋转后Fragment空白、RecyclerView没加载的原因，下面一步步拆解并给出修正方案：

错误1：Activity中Fragment的保存与恢复逻辑完全搞反了 #

你在onSaveInstanceState里调用getFragment是错误的——这个方法是用来读取Bundle里的Fragment，而保存Fragment应该用putFragment；另外，恢复Fragment后你没有把它添加到布局容器中，导致重建后Fragment根本没被显示出来。

错误2：Fragment中RecyclerView状态的保存方式不对 #

你把状态存在成员变量recyclerViewState里，但屏幕旋转时Fragment会被销毁重建，这个成员变量的值会丢失，根本没法用来恢复状态。而且恢复时机也有问题，onActivityCreated里可能RecyclerView还没初始化完成，直接调用会出空指针或者无效恢复。

修正后的Activity代码 #

private static final String LIST_USERS_FRAGMENT = "list_users_fragment";

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main); // 确保你设置了包含Fragment容器的布局

    if (savedInstanceState != null) {
        // 从Bundle中恢复之前保存的Fragment实例
        ListUsersFragment fragment = (ListUsersFragment) getSupportFragmentManager()
                .getFragment(savedInstanceState, LIST_USERS_FRAGMENT);
        // 将恢复的Fragment添加到布局容器中
        getSupportFragmentManager().beginTransaction()
                .replace(R.id.fragment_container, fragment)
                .commit();
    } else {
        // 首次启动时创建并添加Fragment
        ListUsersFragment fragment = new ListUsersFragment();
        getSupportFragmentManager().beginTransaction()
                .add(R.id.fragment_container, fragment)
                .commit();
    }
}

@Override
protected void onSaveInstanceState(Bundle outState) {
    super.onSaveInstanceState(outState);
    // 获取当前显示的Fragment实例，保存到Bundle中
    ListUsersFragment fragment = (ListUsersFragment) getSupportFragmentManager()
            .findFragmentById(R.id.fragment_container);
    if (fragment != null) {
        getSupportFragmentManager().putFragment(outState, LIST_USERS_FRAGMENT, fragment);
    }
}

修正后的Fragment代码 #

private static final String RECYCLER_STATE_KEY = "recycler_view_state";
private RecyclerView list;
private RecyclerView.LayoutManager layoutManager;

@Override
public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
    View view = inflater.inflate(R.layout.fragment_list_users, container, false);
    
    // 初始化RecyclerView和布局管理器
    list = view.findViewById(R.id.recycler_view);
    layoutManager = new LinearLayoutManager(requireContext());
    list.setLayoutManager(layoutManager);
    
    // 这里初始化你的Adapter和加载数据（比如从ViewModel或本地缓存获取）
    // list.setAdapter(yourAdapter);
    // yourAdapter.submitList(yourDataList);
    
    // 恢复RecyclerView的滚动状态（注意：必须确保数据已经加载完成）
    if (savedInstanceState != null) {
        Parcelable recyclerViewState = savedInstanceState.getParcelable(RECYCLER_STATE_KEY);
        if (recyclerViewState != null) {
            layoutManager.onRestoreInstanceState(recyclerViewState);
        }
    }
    
    return view;
}

@Override
public void onSaveInstanceState(@NonNull Bundle outState) {
    super.onSaveInstanceState(outState);
    // 将RecyclerView的滚动状态保存到Bundle中
    if (layoutManager != null) {
        Parcelable recyclerViewState = layoutManager.onSaveInstanceState();
        outState.putParcelable(RECYCLER_STATE_KEY, recyclerViewState);
    }
}

额外注意事项 #

• 确保你的Activity布局里有一个Fragment容器（比如FrameLayout，id为fragment_container），不然Fragment没地方显示。
• 恢复RecyclerView状态时，必须保证RecyclerView已经设置了Adapter并且数据已经加载完成，否则空列表恢复状态是无效的。如果你的数据是异步加载的（比如从网络请求），建议在数据加载完成后再调用layoutManager.onRestoreInstanceState()。
• 如果使用ViewModel来管理数据，旋转屏幕时数据会自动保留，不用额外保存，这会让状态恢复更简单。

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