Android向NavHostFragment内Fragment传值失败，Fragment为空求助

我有一个PatientHome Activity，通过FragmentContainerView结合NavGraph管理3个Fragment；另有一个包含科室列表ListView的Speciality Activity。希望从Speciality Activity发送Intent，将数据传递至PatientHome Activity的首个Fragment（FirstPatientFragment）。

相关代码 #

Patient 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:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".PatientHome">

<com.google.android.material.bottomnavigation.BottomNavigationView
    android:id="@+id/bottomNavigationView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="#fff"
    app:layout_constraintBottom_toBottomOf="parent"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:menu="@menu/patient_bottom_menu"
    app:itemTextColor="@color/bottom_nav_color"
    app:itemIconTint="@color/bottom_nav_color"/>

<androidx.fragment.app.FragmentContainerView
    android:id="@+id/patientfragmentContainerView"
    android:name="androidx.navigation.fragment.NavHostFragment"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:defaultNavHost="true"
    android:tag="customTag"
    app:layout_constraintBottom_toTopOf="@+id/bottomNavigationView"
    app:layout_constraintEnd_toEndOf="parent"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent"
    app:navGraph="@navigation/patient_nav" />
</androidx.constraintlayout.widget.ConstraintLayout>

NavGraph配置 #

<?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/patient_nav"
app:startDestination="@id/firstPatientFragment">

<fragment
    android:id="@+id/firstPatientFragment"
    android:name="com.topaholic.hptracker.FirstPatientFragment"
    android:label="fragment_first_patient"
    tools:layout="@layout/fragment_first_patient" />
<fragment
    android:id="@+id/secondPatientFragment"
    android:name="com.topaholic.hptracker.SecondPatientFragment"
    android:label="fragment_second_patient"
    tools:layout="@layout/fragment_second_patient" />
<fragment
    android:id="@+id/thirdPatientFragment"
    android:name="com.topaholic.hptracker.ThirdPatientFragment"
    android:label="fragment_third_patient"
    tools:layout="@layout/fragment_third_patient" />
</navigation>

Speciality Activity跳转代码 #

Intent intent = new Intent(SpecialityActivity.this, PatientHome.class);
Bundle bundle = new Bundle();
bundle.putString("specialities", getResources().getStringArray(R.array.specialities)[i]);
intent.putExtras(bundle);
Log.d("Speciality", "Bundle sent: " + bundle);
startActivity(intent);

Patient Activity接收并传递数据代码 #

Bundle bundle = getIntent().getExtras();
if (bundle != null) {
    String value = bundle.getString("specialities");
    // pass the data to the fragment using the fragment's arguments
    FragmentManager fragmentManager = getSupportFragmentManager();
    Fragment fragment = fragmentManager.findFragmentById(R.id.firstPatientFragment);
    Log.d("PatientActivity", "Fragment found: " + fragment);
    if (fragment != null) {
        fragment.getArguments().putAll(bundle);
    }
}

FirstPatientFragment接收数据代码 #

Bundle bundle = getArguments();
Log.d("MyFragment", "Bundle received: " + bundle);
if (bundle != null) {
    String value = bundle.getString("specialities");
    specbtn.setText(value);
}

日志输出 #

Speciality Activity: Bundle sent: Bundle[{specialities=Diagnostic Radiology}]
Patient Activity: Fragment found: null
FirstFragment: Bundle received: null

不清楚为何在FragmentContainerView中查找Fragment会返回null，请求解决。

原因分析 #

直接用fragmentManager.findFragmentById(R.id.firstPatientFragment)找不到Fragment有两个核心原因：

1. NavHostFragment管理的子Fragment不属于Activity的直接FragmentManager，而是嵌套在NavHostFragment自己的子FragmentManager中。
2. Activity启动时，NavHostFragment和子Fragment的加载是异步的，在onCreate阶段直接查找会因为Fragment未初始化完成而返回null。

正确实现方式 #

方案一：利用Navigation组件自动传递参数（推荐） #

这是符合Navigation设计规范的最优方案，无需手动查找Fragment：

1. 给起始Fragment添加参数配置
   修改patient_nav.xml，为firstPatientFragment添加参数定义：

<fragment
    android:id="@+id/firstPatientFragment"
    android:name="com.topaholic.hptracker.FirstPatientFragment"
    android:label="fragment_first_patient"
    tools:layout="@layout/fragment_first_patient">
    <argument
        android:name="specialities"
        android:defaultValue=""
        app:argType="string" />
</fragment>

2. Speciality Activity直接传递参数
   跳转代码无需封装Bundle，直接给Intent加参数即可：

Intent intent = new Intent(SpecialityActivity.this, PatientHome.class);
intent.putExtra("specialities", getResources().getStringArray(R.array.specialities)[i]);
Log.d("Speciality", "Data sent: " + getResources().getStringArray(R.array.specialities)[i]);
startActivity(intent);

3. 移除Patient Activity中的手动传递代码
   Navigation组件会自动将Intent中的参数映射到起始Fragment的arguments中，无需额外处理。

方案二：手动获取NavHost的子Fragment #

如果需要自定义参数传递逻辑，可在Fragment加载完成后处理：

1. 在Patient Activity的onStart中处理

@Override
protected void onStart() {
    super.onStart();
    Bundle bundle = getIntent().getExtras();
    if (bundle != null) {
        // 先获取NavHostFragment
        NavHostFragment navHostFragment = (NavHostFragment) getSupportFragmentManager().findFragmentById(R.id.patientfragmentContainerView);
        if (navHostFragment != null) {
            // 通过NavHost的子FragmentManager查找目标Fragment
            Fragment childFragment = navHostFragment.getChildFragmentManager().findFragmentById(R.id.firstPatientFragment);
            if (childFragment instanceof FirstPatientFragment) {
                ((FirstPatientFragment) childFragment).updateSpeciality(bundle.getString("specialities"));
            }
        }
    }
}

2. 在FirstPatientFragment中添加更新方法

public void updateSpeciality(String speciality) {
    if (specbtn != null) {
        specbtn.setText(speciality);
    }
}

方案三：Fragment直接读取Activity Intent参数 #

在Fragment中直接获取宿主Activity的Intent数据：

@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
    super.onViewCreated(view, savedInstanceState);
    Bundle activityBundle = requireActivity().getIntent().getExtras();
    if (activityBundle != null) {
        String value = activityBundle.getString("specialities");
        specbtn.setText(value);
    }
}

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