Android Compose UI测试遇FINGERPRINT非空错误的解决与测试方案

1. LazyVerticalStaggeredGrid测试支持不足：旧版Compose测试库对LazyVerticalStaggeredGrid的测试逻辑不完善，内部用于定位列表项的指纹生成机制未正确初始化，直接抛出FINGERPRINT must not be null空指针。
2. Glide测试环境未配置：GlideImage在测试环境中缺少必要的初始化流程，Glide内部依赖的指纹标识未被赋值，触发空指针异常。
3. 测试上下文不规范：未使用Compose官方推荐的测试规则（如createComposeRule）或协程测试环境，导致组件初始化流程异常，引发内部字段为空。

1. 匹配依赖版本 #

升级Compose测试库到支持LazyVerticalStaggeredGrid的版本（推荐1.6.0及以上），同时添加Glide测试依赖：

// Compose测试核心依赖
androidTestImplementation "androidx.compose.ui:ui-test-junit4:1.6.0"
androidTestImplementation "androidx.compose.ui:ui-test-manifest:1.6.0"

// Glide Compose及测试依赖
androidTestImplementation "com.github.bumptech.glide:compose:1.0.0"
androidTestImplementation "com.github.bumptech.glide:testing:4.16.0"

2. 编写规范UI测试 #

使用createComposeRule作为测试规则，同时为Glide配置测试环境，避免真实网络请求干扰：

import androidx.compose.ui.test.junit4.createComposeRule
import androidx.compose.ui.test.onAllNodesWithContentDescription
import androidx.compose.ui.test.performScrollToIndex
import androidx.test.core.app.ApplicationProvider
import com.bumptech.glide.Glide
import com.bumptech.glide.load.engine.DiskCacheStrategy
import org.junit.Before
import org.junit.Rule
import org.junit.Test

class CatScreenTest {
    @get:Rule
    val composeTestRule = createComposeRule()

    @Before
    fun setupGlide() {
        // 初始化Glide测试环境，禁用磁盘缓存避免测试污染
        val context = ApplicationProvider.getApplicationContext<Context>()
        Glide.get(context).clearMemory()
        Glide.with(context)
            .applyDefaultRequestOptions {
                diskCacheStrategy(DiskCacheStrategy.NONE)
            }
    }

    @Test
    fun catScreen_displaysAllImagesInStaggeredGrid() {
        // 使用本地资源替代网络URL，提升测试稳定性
        val catImageResIds = listOf(
            R.drawable.cat_mock_1,
            R.drawable.cat_mock_2,
            R.drawable.cat_mock_3,
            R.drawable.cat_mock_4,
            R.drawable.cat_mock_5
        )

        // 加载目标Compose组件
        composeTestRule.setContent {
            CatScreen(catImageResIds = catImageResIds)
        }

        // 验证网格图片数量与测试数据一致
        composeTestRule.onAllNodesWithContentDescription("Cat image")
            .assertCountEquals(catImageResIds.size)

        // 滚动到指定索引项并验证可见性
        val targetIndex = 3
        composeTestRule.onAllNodesWithContentDescription("Cat image")[targetIndex]
            .performScrollToIndex(targetIndex)
            .assertIsDisplayed()
    }
}

3. 组件代码优化（辅助测试） #

确保CatScreen中的GlideImage设置明确的contentDescription，方便测试定位：

// CatScreen内的GlideImage示例
GlideImage(
    model = imageResId,
    contentDescription = "Cat image", // 必须设置，用于测试节点定位
    modifier = Modifier.size(120.dp)
)

4. 额外注意事项 #

• 优先使用本地drawable资源或MockGlide模拟图片加载，避免真实网络请求导致的测试不稳定。
• 若仍出现指纹空指针，可升级Compose BOM版本，确保所有Compose相关依赖版本统一。

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