在Fragment中使用Compose时遇ViewPager2报错及锁验证问题求助

一、E/RecyclerView: No adapter attached; skipping layout 报错原因及解决 #

原因分析 #

1. 视图初始化顺序冲突：FirstScreenFragment在onCreateView中通过activity?.findViewById<ViewPager2>(R.id.viewPager)获取ViewPager2时，ViewPager2所在的ViewPagerFragment还在通过Compose的AndroidView加载布局，此时ViewPager2尚未被添加到Activity视图树，返回值为null。尽管没有出现Fragment被跳过的现象，但这个错误时机导致ViewPager2短暂处于无Adapter状态，触发了RecyclerView的报错。
2. ViewPager2初始化不规范：ViewPagerFragment中使用inflate(R.layout.fragment_view_pager, null, false)加载布局时未传入父容器，导致ViewPager2布局参数异常，间接引发Adapter附着时机问题。

解决方案 #

方案1：移除子Fragment直接获取ViewPager2的逻辑

改用事件驱动实现页面切换，避免直接跨Fragment查找视图：

• 定义ViewModel管理页面切换事件：

class OnBoardingViewModel : ViewModel() {
    val pageSwitchEvent = MutableSharedFlow<Int>()

    suspend fun switchToPage(page: Int) {
        pageSwitchEvent.emit(page)
    }
}

• 在ViewPagerFragment中监听事件并切换页面：

class ViewPagerFragment : Fragment() {
    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        val view = inflater.inflate(R.layout.fragment_view_pager, container, false)
        val viewPager = view.findViewById<ViewPager2>(R.id.viewPager)
        val viewModel = viewModel<OnBoardingViewModel>()
        
        // 监听页面切换事件
        lifecycleScope.launch {
            viewModel.pageSwitchEvent.collect { page ->
                viewPager.setCurrentItem(page, true)
            }
        }
        
        // 初始化Adapter
        val fragmentList = arrayListOf(
            FirstScreenFragment(),
            SecondScreenFragment(),
            ThirdScreenFragment()
        )
        val adapter = ViewPagerAdapter(fragmentList, childFragmentManager, lifecycle)
        viewPager.adapter = adapter
        return view
    }
}

• 在子Fragment的Compose页面中触发切换：

// OnBoardingPage组件内
val viewModel = viewModel<OnBoardingViewModel>()
Button(onClick = {
    lifecycleScope.launch {
        viewModel.switchToPage(currentPage + 1)
    }
}) {
    Text("Next")
}

方案2：规范ViewPager2初始化方式

将ViewPagerFragment改为直接返回原生视图，避免用Compose包裹原生布局：

class ViewPagerFragment : Fragment() {
    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        val view = inflater.inflate(R.layout.fragment_view_pager, container, false)
        val fragmentList = arrayListOf(
            FirstScreenFragment(),
            SecondScreenFragment(),
            ThirdScreenFragment()
        )
        // 使用childFragmentManager而非Activity的supportFragmentManager，绑定正确生命周期
        val adapter = ViewPagerAdapter(fragmentList, childFragmentManager, lifecycle)
        val viewPager = view.findViewById<ViewPager2>(R.id.viewPager)
        viewPager.adapter = adapter
        return view
    }
}

二、SnapshotStateList failed lock verification 警告原因及解决 #

原因分析 #

该警告是Compose运行时锁校验失败导致，常见触发场景：

• Debug模式下JIT（即时编译）优化逻辑与锁校验规则冲突；
• Compose依赖版本不统一，引发兼容性问题；
• ProGuard/R8配置错误，破坏了Compose运行时类结构。

解决方案 #

方案1：Debug模式下忽略或禁用JIT

Debug模式下警告不影响功能，若要消除可在app/build.gradle添加配置强制使用AOT编译：

android {
    buildTypes {
        debug {
            dexOptions {
                preDexLibraries = false
                dexInProcess = true
            }
            kotlinOptions {
                jvmTarget = "1.8"
            }
        }
    }
}

方案2：统一Compose依赖版本

使用Compose BOM管理所有Compose库版本，避免版本不一致：

dependencies {
    implementation platform('androidx.compose:compose-bom:2024.04.00')
    implementation 'androidx.compose.ui:ui'
    implementation 'androidx.compose.material3:material3'
    implementation 'androidx.compose.ui:ui-tooling-preview'
    debugImplementation 'androidx.compose.ui:ui-tooling'
}

方案3：修复Release模式ProGuard配置

若Release模式出现警告，在proguard-rules.pro中添加Compose规则：

# 保留Compose运行时核心类
-keep class androidx.compose.runtime.** { *; }
-keep class androidx.compose.ui.** { *; }
-keep class androidx.compose.material3.** { *; }
-dontwarn androidx.compose.runtime.**
-dontwarn androidx.compose.ui.**

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