将MaxNative广告加载到RecyclerView时出现视图已存在父容器错误

编写代码将AppLovin的MaxNative广告加载到RecyclerView中，首次加载后复用全局变量globalNativeAd展示广告，但运行时出现崩溃，抛出异常：

java.lang.IllegalStateException: The specified child already has a parent. You must call removeView() on the child's parent first

相关代码 #

fun showNativeAd2(adContainer: FrameLayout) {
        val params = adContainer.layoutParams
        params.height = 300.px

        adContainer.layoutParams = params
        if (isPremium()) {
            adContainer.visibility = View.GONE
            return
        }
        adContainer.visibility = View.VISIBLE
        val nativeAdLoader = MaxNativeAdLoader(adMobIds.nativeId, adContainer.context)

        nativeAdLoader.setNativeAdListener(object : MaxNativeAdListener() {

            override fun onNativeAdLoaded(nativeAdView: MaxNativeAdView?, ad: MaxAd) {
                // Clean up any pre-existing native ad to prevent memory leaks.
                if (nativeAd != null) {
                    nativeAdLoader.destroy(nativeAd)
                }
                nativeAd = ad
                globalNativeAd = nativeAdView

                adContainer.removeAllViews()
                adContainer.addView(nativeAdView)
            }

            override fun onNativeAdLoadFailed(adUnitId: String, error: MaxError) {
                // We recommend retrying with exponentially higher delays up to a maximum delay
                log("$adUnitId  $error")
            }

            override fun onNativeAdClicked(ad: MaxAd) {
                log("$ad")
            }
        })
        if (globalNativeAd == null)
            nativeAdLoader.loadAd()
        else{
            adContainer.removeAllViews()
            adContainer.addView(globalNativeAd)
        }
    } 

崩溃堆栈 #

2023-04-27 12:15:29.952 10265-10265/com.thesrb.bluewords E/CustomActivityOnCrash: The previous app process crashed. This is the stack trace of the crash:
    java.lang.IllegalStateException: The specified child already has a parent. You must call removeView() on the child's parent first.
        at android.view.ViewGroup.addViewInner(ViewGroup.java:5269)
        at android.view.ViewGroup.addView(ViewGroup.java:5090)
        at android.view.ViewGroup.addView(ViewGroup.java:5030)
        at android.view.ViewGroup.addView(ViewGroup.java:5003)
        at com.thesrb.bluewords.ads_libs.AppLovinUtils.showNativeAd2(AppLovinUtils.kt:161)
        at com.thesrb.bluewords.adapter.WordAdapter.setAds(WordAdapter.kt:217)
        at com.thesrb.bluewords.adapter.WordAdapter.onBindViewHolder(WordAdapter.kt:188)
        at com.thesrb.bluewords.adapter.WordAdapter.onBindViewHolder(WordAdapter.kt:32)
        at androidx.recyclerview.widget.RecyclerView$Adapter.onBindViewHolder(RecyclerView.java:7254)
        at androidx.recyclerview.widget.RecyclerView$Adapter.bindViewHolder(RecyclerView.java:7337)
        at androidx.recyclerview.widget.RecyclerView$Recycler.tryBindViewHolderByDeadline(RecyclerView.java:6194)
        at androidx.recyclerview.widget.RecyclerView$Recycler.tryGetViewHolderForPositionByDeadline(RecyclerView.java:6460)
        at androidx.recyclerview.widget.RecyclerView$Recycler.getViewForPosition(RecyclerView.java:6300)
        at androidx.recyclerview.widget.RecyclerView$Recycler.getViewForPosition(RecyclerView.java:6296)
        at androidx.recyclerview.widget.LinearLayoutManager$LayoutState.next(LinearLayoutManager.java:2330)
        at androidx.recyclerview.widget.LinearLayoutManager.layoutChunk(LinearLayoutManager.java:1631)
        at androidx.recyclerview.widget.LinearLayoutManager.fill(LinearLayoutManager.java:1591)

解决方案 #

问题根源

globalNativeAd是一个MaxNativeAdView实例，当它首次被添加到某个adContainer后，就已经关联了父布局。RecyclerView复用ViewHolder时，你尝试将同一个视图实例添加到新的adContainer中，而Android不允许一个View同时属于两个父布局，因此触发该异常。

修复方案

方案1：临时移除原父布局中的视图

如果坚持复用MaxNativeAdView实例，在添加到新容器前，先将其从原父布局中移除：

else{
    // 先从原父布局中移除视图
    (globalNativeAd?.parent as? ViewGroup)?.removeView(globalNativeAd)
    adContainer.removeAllViews()
    adContainer.addView(globalNativeAd)
}

⚠️ 注意：这种方式可能引发视图状态混乱或内存泄漏，不推荐作为长期方案。

方案2：遵循AppLovin最佳实践，复用MaxAd而非视图

AppLovin推荐复用MaxAd广告实例，而非MaxNativeAdView视图实例。每次展示广告时，基于全局保存的MaxAd创建新的视图并绑定到当前容器：

修改代码如下：

// 将全局变量改为保存MaxAd实例，而非视图
private var globalNativeAd: MaxAd? = null

fun showNativeAd2(adContainer: FrameLayout) {
    val params = adContainer.layoutParams
    params.height = 300.px
    adContainer.layoutParams = params
    
    if (isPremium()) {
        adContainer.visibility = View.GONE
        return
    }
    adContainer.visibility = View.VISIBLE
    
    val nativeAdLoader = MaxNativeAdLoader(adMobIds.nativeId, adContainer.context)
    nativeAdLoader.setNativeAdListener(object : MaxNativeAdListener() {
        override fun onNativeAdLoaded(nativeAdView: MaxNativeAdView?, ad: MaxAd) {
            // 销毁旧广告实例，避免内存泄漏
            nativeAd?.let { nativeAdLoader.destroy(it) }
            nativeAd = ad
            globalNativeAd = ad // 全局保存广告实例
            
            adContainer.removeAllViews()
            nativeAdView?.let { adContainer.addView(it) }
        }

        override fun onNativeAdLoadFailed(adUnitId: String, error: MaxError) {
            log("$adUnitId  $error")
        }

        override fun onNativeAdClicked(ad: MaxAd) {
            log("$ad")
        }
    })
    
    if (globalNativeAd == null) {
        nativeAdLoader.loadAd()
    } else {
        // 基于全局广告实例创建新视图并绑定
        val adView = nativeAdLoader.getNativeAdView(globalNativeAd, adContainer.context)
        adContainer.removeAllViews()
        adView?.let { adContainer.addView(it) }
    }
}

这种方式每次展示广告都会创建新的MaxNativeAdView，绑定到当前的容器，既避免了同一视图多父布局的问题，也符合AppLovin的广告生命周期管理规范，能有效减少内存泄漏风险。

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