重复导航时SupportMapFragment onDestroy处理与重复ID报错排查

问题现象 #

使用SupportMapFragment开发地图子页面，主界面通过按钮触发视图切换时，首次进入地图页运行正常，第二次导航执行setContentView方法时抛出异常：

Duplicate id 0x7f080180, tag null, or parent id 0xffffffff with another fragment for com.google.android.gms.maps.SupportMapFragment

尝试在返回主界面时调用remove、detach方法移除MapFragment仍无法解决问题。

原始问题代码 #

地图页布局代码 #

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <fragment
            android:id="@+id/map"
            android:name="com.google.android.gms.maps.SupportMapFragment"
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1"
            tools:context=".MainActivity" />

        <Button
            android:id="@+id/back"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/back" />

    </LinearLayout>

</androidx.constraintlayout.widget.ConstraintLayout>

视图切换逻辑代码 #

fun loadMapView(view: View) {
    mapFragmentManager= supportFragmentManager;
    
    // First navigation
    if (mapFragment==null){
        val mapFragment = SupportMapFragment.newInstance()
        mapFragmentManager
        .beginTransaction()
        .replace(R.id.map, mapFragment!!)
        .commit()

        mapFragment!!.getMapAsync(this);
    }
    // Second, Third, ... Navigation
    else {
            mapFragmentManager
                .beginTransaction()
                .attach(mapFragment!!)
                .commit()
        }

        setContentView(R.layout.mapView) // Throwing Error when navigating second time
        
        // Setup Backbutton
        val back = findViewById<Button>(R.id.back)
        back.setOnClickListener {
            // Remove Mapfragment (also tried detach)
            mapFragmentManager.beginTransaction().remove(mapFragment!!).commit()

        // Navigate to main screen
        setActivityMain()
    }
}

问题根因 #

• 布局中使用静态<fragment>标签声明SupportMapFragment：每次调用setContentView加载地图布局时，系统会自动尝试实例化该标签对应的SupportMapFragment，和之前残留的动态添加的同ID片段实例冲突
• 变量作用域错误：第一次初始化片段时在if判断块内声明了局部mapFragment变量，没有给类级别的mapFragment成员变量赋值，导致后续逻辑判断失效
• 执行顺序错误：setContentView在片段事务之后调用，且片段事务默认是异步提交，返回主界面时调用remove后没有等事务执行完成就切换布局，导致旧的片段实例残留在FragmentManager中
• 重复创建片段：静态fragment标签自动创建的实例和代码中动态创建的SupportMapFragment实例ID重复，直接触发重复ID异常

修复步骤 #

• 修改地图页布局：将静态<fragment>标签替换为普通FrameLayout作为地图片段容器，避免系统自动创建片段实例
  修改后的布局代码：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <!-- 替换为普通容器，不要静态声明fragment -->
        <FrameLayout
            android:id="@+id/map_container"
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1" />

        <Button
            android:id="@+id/back"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/back" />

    </LinearLayout>

</androidx.constraintlayout.widget.ConstraintLayout>

• 修复变量作用域和执行顺序：先加载布局，再操作片段事务，创建片段时直接赋值给类成员变量，不要声明局部变量覆盖
• 同步执行片段移除事务：返回主界面时，使用commitNow()同步执行移除操作，确保旧片段完全销毁后再切换主布局，避免残留
  修复后的逻辑代码：

// 类级别成员变量，不要在方法里重新声明
private var mapFragment: SupportMapFragment? = null
private lateinit var mapFragmentManager: FragmentManager

fun loadMapView(view: View) {
    // 先加载布局，再做后续操作
    setContentView(R.layout.mapView)
    mapFragmentManager = supportFragmentManager

    // 首次进入创建新片段
    if (mapFragment == null) {
        mapFragment = SupportMapFragment.newInstance()
        mapFragment!!.getMapAsync(this)
    }

    // 把片段添加到容器中
    mapFragmentManager.beginTransaction()
        .replace(R.id.map_container, mapFragment!!)
        .commit()

    // 初始化返回按钮
    val back = findViewById<Button>(R.id.back)
    back.setOnClickListener {
        // 同步移除片段，确保销毁完成再切换布局
        mapFragment?.let {
            mapFragmentManager.beginTransaction()
                .remove(it)
                .commitNow()
        }
        // 切回主界面
        setActivityMain()
    }
}

注意点 #

• 不要在布局里用静态<fragment>标签搭配动态事务操作同一个片段，很容易出现实例重复问题
• 涉及SupportMapFragment这类有独立生命周期的系统片段，移除操作尽量用commitNow()保证事务同步执行，不要用异步commit()后马上切换视图
• 不要在代码块里声明和类成员同名的局部变量，会导致成员变量赋值失效

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