Android Navigation组件中Fragment无法显示、切换异常求助

问题现象 #

启动应用后，RecyclerView所在Fragment和普通Fragment均无法显示，确认Navigation已执行Fragment切换操作但无视觉反馈；加入saveInstanceState判断后，RecyclerView能正常工作，但Fragment彻底无法切换。

核心原因 #

1. 手动Fragment事务干扰Navigation管理：在MainActivity的onCreate中，直接通过Fragment事务往nav_host_fragment_container添加Fragment，覆盖了Navigation组件管理的NavHostFragment，导致Navigation的切换逻辑失效。
2. NavGraph中Fragment类路径错误：helloworld Fragment的android:name前缀缺失，与其他Fragment包名不一致，可能导致实例化失败。
3. 自定义Activity构造函数干扰初始化：MainActivity中自定义了带布局参数的构造函数，干扰了Activity的正常初始化流程。

解决方案 #

1. 移除手动添加Fragment的代码 #

删除onCreate中if (savedInstanceState == null)代码块，Navigation会自动根据nav_graph的startDestination加载初始Fragment。

2. 修正NavGraph中Fragment的类路径 #

将helloworld Fragment的android:name改为musicstore.fragments.helloworld，与其他Fragment保持一致的包名。

3. 删除自定义Activity构造函数 #

移除public MainActivity() { super(R.layout.main); }，保留默认无参构造，布局加载由onCreate中的setContentView(R.layout.main)完成。

4. 验证RecyclerView数据加载 #

确保ProductListAdapter正确从MusicStoreService获取数据，避免空数据导致RecyclerView无内容。

修改后的关键代码 #

MainActivity.java #

public class MainActivity extends AppCompatActivity {
    MusicStoreService music;
    private DrawerLayout drawerLayout;
    private NavController navController;
    private NavigationView navigationView;
    private AppBarConfiguration appBarConfiguration;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        music = new MusicStoreServiceMock();

        setContentView(R.layout.main);

        Toolbar toolbar = findViewById(R.id.toolbar);
        setSupportActionBar(toolbar);

        drawerLayout = findViewById(R.id.drawer_layout);
        navigationView = findViewById(R.id.nav_view);
        NavHostFragment navHostFragment = (NavHostFragment)
                getSupportFragmentManager()
                        .findFragmentById(R.id.nav_host_fragment_container);
        navController = navHostFragment.getNavController();

        Set<Integer> topLevelDestinations = new HashSet<>();
        topLevelDestinations.add(R.id.productListFragment2);
        topLevelDestinations.add(R.id.helloworld);

        appBarConfiguration = new AppBarConfiguration.Builder(topLevelDestinations)
                .setOpenableLayout(drawerLayout)
                .build();

        NavigationUI.setupWithNavController(toolbar, navController,
                appBarConfiguration);
        NavigationUI.setupWithNavController(navigationView, navController);
    }

    public MusicStoreService getMusic() {
        return music;
    }
}

nav_graph.xml #

<?xml version="1.0" encoding="utf-8"?>
<navigation 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/nav_graph"
    app:startDestination="@id/productListFragment2">
    <fragment
        android:id="@+id/productListFragment2"
        android:name="musicstore.fragments.ProductListFragment"
        android:label="Product List" >
        <action
            android:id="@+id/action_productListFragment2_to_mainActivity2"
            app:destination="@id/mainActivity2" />
    </fragment>
    <fragment
        android:id="@+id/helloworld"
        android:name="musicstore.fragments.helloworld"
        android:label="Your Account"
        tools:layout="@layout/fragment_helloworld" />
    <fragment
        android:id="@+id/productDetailFragment2"
        android:name="musicstore.fragments.ProductDetailFragment"
        android:label="ProductDetailFragment" />
    <activity
        android:id="@+id/mainActivity2"
        android:name="musicstore.MainActivity"
        android:label="activity_main"
        tools:layout="@layout/activity_main" />
</navigation>

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