Espresso测试Android应用图片验证部分失败，求助排查原因

我刚接触Espresso做Android UI测试时，也踩过图片验证的坑，结合你遇到的报错（断言资源ID不匹配），来分析下几种常见原因和对应的解决办法：

一、常见原因分析 #

• 资源ID不匹配或动态加载的图片：Espresso自带的withDrawable(R.id.xxx)是直接匹配View设置的Drawable对应的资源ID，但如果你的图片是通过Glide/Picasso加载的网络图、本地文件图，或者是代码里动态创建的Drawable（不是直接从资源ID设置的），那这个断言肯定会失败——因为这些Drawable根本没有绑定对应的资源ID。另外，debug/release构建变体的资源ID可能不同，也会导致匹配失败。
• 图片未加载完成就执行断言：如果用了图片加载库，Espresso可能在图片还没加载完成时就跑了断言，此时ImageView的Drawable还是默认占位图或者null，自然匹配不上目标资源ID。
• Drawable被修改过状态或样式：比如图片被设置了tint颜色、缩放、或者有选中/未选中的状态变体，这时候实际显示的Drawable和原始资源ID对应的Drawable已经不是同一个实例，资源ID匹配就会失效。

二、对应的解决办法 #

1. 区分静态资源和动态加载图片的断言方式 #

• 如果是静态设置的资源图片（布局里直接用android:src或代码里setImageResource()设置的）：先确认测试用的构建变体（debug/release）和资源ID一致，比如测试代码里的R.drawable.xxx要和当前构建变体的资源ID对应。
• 如果是动态加载的图片：放弃资源ID匹配，改用内容对比（比如Bitmap像素对比），用自定义Matcher来实现。

2. 等待图片加载完成再断言 #

如果用了Glide/Picasso这类加载库，需要注册对应的IdlingResource让Espresso等待加载完成：
以Glide为例：

// 在测试方法开始前注册IdlingResource
GlideIdlingResource glideIdlingResource = new GlideIdlingResource(Glide.get(getInstrumentation().getTargetContext()));
Espresso.registerIdlingResources(glideIdlingResource);

// 执行你的测试操作和断言
onView(withId(R.id.target_image_view))
    .check(matches(withDrawable(R.drawable.expected_image)));

// 测试结束后注销资源
Espresso.unregisterIdlingResources(glideIdlingResource);

注：Glide的IdlingResource需要添加对应的依赖，比如androidx.test.espresso:espresso-idling-resource:3.5.1，同时Glide版本要适配。

3. 自定义Matcher对比Drawable内容 #

如果因为Drawable状态/样式修改导致资源ID匹配失败，可以自定义Matcher对比Drawable的实际内容：

public static Matcher<View> withDrawableContent(final int expectedResId) {
    return new TypeSafeMatcher<View>() {
        @Override
        protected boolean matchesSafely(View target) {
            if (!(target instanceof ImageView)) {
                return false;
            }
            ImageView imageView = (ImageView) target;
            Context context = imageView.getContext();
            
            Drawable expectedDrawable = ContextCompat.getDrawable(context, expectedResId);
            Drawable actualDrawable = imageView.getDrawable();
            
            if (expectedDrawable == null || actualDrawable == null) {
                return false;
            }
            
            // 转换为Bitmap对比像素
            Bitmap expectedBitmap = drawableToBitmap(expectedDrawable);
            Bitmap actualBitmap = drawableToBitmap(actualDrawable);
            
            return expectedBitmap.sameAs(actualBitmap);
        }

        @Override
        public void describeTo(Description description) {
            description.appendText("with drawable content matching resource ID: " + expectedResId);
        }
    };
}

// 将Drawable转换为Bitmap的工具方法
private static Bitmap drawableToBitmap(Drawable drawable) {
    if (drawable instanceof BitmapDrawable) {
        return ((BitmapDrawable) drawable).getBitmap();
    }
    
    // 处理VectorDrawable等非BitmapDrawable类型
    Bitmap bitmap = Bitmap.createBitmap(
        drawable.getIntrinsicWidth(),
        drawable.getIntrinsicHeight(),
        Bitmap.Config.ARGB_8888
    );
    Canvas canvas = new Canvas(bitmap);
    drawable.setBounds(0, 0, canvas.getWidth(), canvas.getHeight());
    drawable.draw(canvas);
    return bitmap;
}

使用时直接替换自带的Matcher：

onView(withId(R.id.target_image_view))
    .check(matches(withDrawableContent(R.drawable.expected_image)));

三、排查小技巧 #

• 可以在测试中临时打印ImageView的Drawable信息，看看实际显示的是什么：

ImageView imageView = (ImageView) onView(withId(R.id.target_image_view))
    .perform(ViewActions.click())
    .getRootView()
    .findViewById(R.id.target_image_view);

Drawable actualDrawable = imageView.getDrawable();
Log.d("EspressoTest", "Actual Drawable type: " + actualDrawable.getClass().getSimpleName());
// 如果是BitmapDrawable，可以打印尺寸等信息
if (actualDrawable instanceof BitmapDrawable) {
    Bitmap bitmap = ((BitmapDrawable) actualDrawable).getBitmap();
    Log.d("EspressoTest", "Bitmap size: " + bitmap.getWidth() + "x" + bitmap.getHeight());
}

• 确认测试的ImageView确实是你要验证的那个，有没有布局重叠、ID重复的情况。

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