显示含ViewPager2的DialogFragment时应用无报错UI冻结

你遇到的无报错UI冻结属于主线程阻塞导致的ANR，没有常规崩溃堆栈是因为问题出在布局测量的无限循环里，核心诱因按优先级排序：

• 核心触发点：布局测量死循环：你在RelativeLayout中给ViewPager2同时设置android:layout_below="@id/tabLayout"和android:layout_height="match_parent"，ViewPager2自身的递归测量逻辑和RelativeLayout的约束规则冲突，会触发无限次onMeasure调用，直接占满主线程，既不会抛出可捕获的崩溃日志，也无法响应任何用户操作。
• 潜在风险：嵌套Fragment生命周期错乱。如果你的PagerAdapter继承自FragmentStateAdapter，初始化时若错误使用宿主Activity的supportFragmentManager而非DialogFragment的childFragmentManager，会导致子Fragment生命周期绑定错误，也可能引发界面卡死。
• 潜在风险：资源泄漏。你没有在视图销毁时释放ViewPager2适配器、解绑TabLayoutMediator，二次打开弹窗时容易触发引用泄漏导致的异常。

1. 修正布局，消除测量冲突 #

将包裹TabLayout和ViewPager2的RelativeLayout替换为垂直方向的LinearLayout，给ViewPager2设置layout_weight占满剩余空间，从根源上避免无限测量：

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <com.google.android.material.appbar.AppBarLayout
        android:id="@+id/appbar"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentTop="true">

        <com.google.android.material.appbar.MaterialToolbar
            android:id="@+id/toolbar"
            style="@style/Toolbar"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            app:menu="@menu/menu_save"
            app:navigationIcon="@drawable/icon_close"
            app:title="@string/set_site" />

    </com.google.android.material.appbar.AppBarLayout>

    <LinearLayout
        android:layout_below="@id/appbar"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">

        <com.google.android.material.tabs.TabLayout
            android:id="@+id/tabLayout"
            android:layout_width="match_parent"
            android:layout_height="wrap_content" />

        <androidx.viewpager2.widget.ViewPager2
            android:id="@+id/viewPager"
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1" />

    </LinearLayout>

</RelativeLayout>

2. 确保PagerAdapter使用正确的FragmentManager #

PagerAdapter继承FragmentStateAdapter时，构造方法传入外层DialogFragment实例即可，此时会自动使用DialogFragment的childFragmentManager管理子Fragment，参考正确实现：

class PagerAdapter(fragment: Fragment) : FragmentStateAdapter(fragment) {
    companion object {
        const val PAGE_SEARCH = 0
        const val PAGE_FREE_INPUT = 1
    }

    override fun getItemCount(): Int = 2

    override fun createFragment(position: Int): Fragment {
        return when(position) {
            PAGE_SEARCH -> SearchSiteFragment()
            PAGE_FREE_INPUT -> FreeInputFragment()
            else -> throw IllegalArgumentException("Invalid page position")
        }
    }
}

3. 补全视图销毁时的资源释放逻辑 #

在DialogFragment中持有TabLayoutMediator的引用，在onDestroyView中完成所有资源解绑，避免内存泄漏：

@AndroidEntryPoint
class SetSiteDialog : DialogFragment() {

    private var _binding: DialogSetSiteBinding? = null
    private val binding get() = _binding!!
    private var tabLayoutMediator: TabLayoutMediator? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setStyle(STYLE_NORMAL, R.style.AppTheme_FullScreenDialog)
    }

    override fun onStart() {
        super.onStart()
        dialog?.window?.setLayout(
            ViewGroup.LayoutParams.MATCH_PARENT,
            ViewGroup.LayoutParams.MATCH_PARENT
        )
    }
    
    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        _binding = DialogSetSiteBinding.inflate(inflater, container, false)

        binding.viewPager.adapter = PagerAdapter(this)

        tabLayoutMediator = TabLayoutMediator(binding.tabLayout, binding.viewPager) { tab, position ->
            tab.text = when (position) {
                PagerAdapter.PAGE_SEARCH -> getString(R.string.dialog_location_specification_option_search)
                PagerAdapter.PAGE_FREE_INPUT -> getString(R.string.dialog_location_specification_option_self)
                else -> ""
            }
        }
        tabLayoutMediator?.attach()

        return binding.root
    }

    override fun onDestroyView() {
        tabLayoutMediator?.detach()
        tabLayoutMediator = null
        binding.viewPager.adapter = null
        _binding = null
        super.onDestroyView()
    }

}

修改完成后重新编译运行，弹窗可正常弹出，Tab切换、ViewPager滑动、子Fragment输入操作都可正常响应，不会再出现无理由冻结的问题。

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