Android中FragmentTransaction引发内存泄漏的解决方法咨询

问题背景 #

通过LeakCanary监控发现，YouTubeActivity在执行Fragment切换操作时存在内存泄漏。该Activity通过new关键字直接实例化NetworkFragment和MyListFragment作为成员变量，在底部导航切换时调用setFragment方法，通过replace完成Fragment事务提交。

相关代码如下：

public class YouTubeActivity extends AppCompatActivity {

    private final NetworkFragment networkFragment = new NetworkFragment();
    private final MyListFragment myListFragment = new MyListFragment();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
        setContentView(R.layout.activity_you_tube);

        BottomNavigationView bottomNavigationMenu = findViewById(R.id.bottomNavigationMenu);

        setFragment(networkFragment);
        bottomNavigationMenu.setSelectedItemId(R.id.search_YouTube);
        bottomNavigationMenu.setOnNavigationItemSelectedListener(item -> {
            if(item.isChecked())
                return true;
            else{
                if(item.getItemId() == R.id.search_YouTube){
                    setFragment(networkFragment);
                    return true;
                }else if(item.getItemId() == R.id.search_my_list){
                    setFragment(myListFragment);
                    return true;
                }else{
                    setFragment(networkFragment);
                    return true;
                }
            }
        });

        Objects.requireNonNull(getSupportActionBar()).setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM);
        getSupportActionBar().setCustomView(R.layout.custom_action_bar_3);
    }

    private void setFragment(Fragment fragment){
        getSupportFragmentManager()
                .beginTransaction()
                .replace(R.id.main_frame, fragment)
                .commit();
    }
}

泄漏原因分析 #

• Activity以强引用持有Fragment实例（final成员变量），同时Fragment会被FragmentManager持有引用。当Activity生命周期结束后，由于Activity与Fragment之间的双向强引用，GC无法回收Activity实例，导致内存泄漏。
• replace操作会将旧Fragment从容器中移除，但Activity持有的强引用会让Fragment无法被回收，进而拖累Activity也无法被回收。

解决方案 #

1. 让FragmentManager管理Fragment实例，移除Activity的强引用 #

不在Activity中存储Fragment的成员变量，而是通过tag标记Fragment，每次切换时先从FragmentManager中查找实例，不存在再创建。这样Activity不持有Fragment的强引用，Fragment的生命周期完全由FragmentManager管理，Activity销毁时FragmentManager会自动释放相关引用。

修改后的代码示例：

public class YouTubeActivity extends AppCompatActivity {

    private static final String TAG_NETWORK_FRAGMENT = "network_fragment";
    private static final String TAG_MY_LIST_FRAGMENT = "my_list_fragment";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        getWindow().addFlags(WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON);
        setContentView(R.layout.activity_you_tube);

        BottomNavigationView bottomNavigationMenu = findViewById(R.id.bottomNavigationMenu);

        // 仅在首次创建时初始化Fragment，避免配置重建重复创建
        if (savedInstanceState == null) {
            setFragment(TAG_NETWORK_FRAGMENT, NetworkFragment.class);
        }
        bottomNavigationMenu.setSelectedItemId(R.id.search_YouTube);
        bottomNavigationMenu.setOnNavigationItemSelectedListener(item -> {
            if(item.isChecked())
                return true;
            else{
                if(item.getItemId() == R.id.search_YouTube){
                    setFragment(TAG_NETWORK_FRAGMENT, NetworkFragment.class);
                    return true;
                }else if(item.getItemId() == R.id.search_my_list){
                    setFragment(TAG_MY_LIST_FRAGMENT, MyListFragment.class);
                    return true;
                }else{
                    setFragment(TAG_NETWORK_FRAGMENT, NetworkFragment.class);
                    return true;
                }
            }
        });

        Objects.requireNonNull(getSupportActionBar()).setDisplayOptions(ActionBar.DISPLAY_SHOW_CUSTOM);
        getSupportActionBar().setCustomView(R.layout.custom_action_bar_3);
    }

    private void setFragment(String tag, Class<? extends Fragment> fragmentClass) {
        FragmentManager fragmentManager = getSupportFragmentManager();
        Fragment fragment = fragmentManager.findFragmentByTag(tag);

        // 仅当Fragment不存在时才创建实例
        if (fragment == null) {
            try {
                fragment = fragmentClass.newInstance();
            } catch (InstantiationException | IllegalAccessException e) {
                e.printStackTrace();
                return;
            }
        }

        fragmentManager.beginTransaction()
                .replace(R.id.main_frame, fragment, tag)
                .commit();
    }
}

2. 清理Fragment内部的强引用 #

如果Fragment内部存在异步任务、Handler、监听器等组件，要确保这些组件不持有Activity的强引用：

• 用WeakReference<Activity>包裹Activity实例；
• 在Fragment的onDestroyView或onDestroy方法中取消异步任务、移除Handler回调、注销监听器。

3. 规范FragmentTransaction提交时机 #

避免在Activity生命周期处于非活跃状态（比如onSaveInstanceState之后）提交事务，必要时可以使用commitAllowingStateLoss（需谨慎，可能丢失状态），或者在Activity的onDestroy中确认未执行的事务已被FragmentManager处理。

弱引用是否可行？ #

不推荐用弱引用解决该场景的泄漏问题，原因如下：

• 即使Activity持有Fragment的弱引用，Fragment仍会被FragmentManager持有强引用，无法从根源切断Activity与Fragment的双向强引用；
• 弱引用会增加代码复杂度，每次获取Fragment实例都要检查是否已被GC回收，容易引发空指针异常；
• 真正的泄漏根源是Activity持有Fragment的强引用，让FragmentManager管理实例才是更直接有效的解决方案。

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