Android connectedAndroidTest执行异常：未检测到测试用例但APK含测试类

嘿，我之前也踩过这个一模一样的坑——明明测试APK里能看到测试类，跑connectedAndroidTest却死活提示「NO tests found」，折腾了好半天终于理清了几个最可能的原因，给你挨个梳理下：

1. 测试类/方法的注解&结构是否合规 #

这是最容易踩的坑！首先得确认你的测试类用对了Instrumented测试的规范：

• 测试类顶部必须加@RunWith(AndroidJUnit4.class)（JUnit4环境）或者适配JUnit5的@ExtendWith(AndroidExtension.class)
• 每个测试方法都要加@Test注解，而且这个注解必须来自org.junit.Test（别搞错成JUnit Jupiter或者其他包的）
• 测试方法得是public、无参数、返回void的，要是写成private或者加了参数，JUnit根本识别不到

举个正确的Instrumented测试类示例：

import androidx.test.ext.junit.runners.AndroidJUnit4;
import org.junit.Test;
import org.junit.runner.RunWith;

@RunWith(AndroidJUnit4.class)
public class MainActivityInstrumentedTest {
    @Test
    public void testLaunchActivity() {
        // 你的测试逻辑
    }
}

2. 检查构建配置里的测试过滤规则 #

有时候不是测试类的问题，而是构建脚本或者命令行参数给测试加了过滤：

• 看看你执行命令的时候有没有加--tests参数，比如./gradlew connectedAndroidTest --tests "com.myapp.tests.*"，要是你的测试类不在这个包路径下，自然找不到
• 打开app模块的build.gradle，检查android.testOptions里有没有配置过滤规则，比如：

  android {
      testOptions {
          unitTests.all {
              filter {
                  includeTestsMatching "com.myapp.only.this.package.*"
              }
          }
      }
  }
  

  要是有这种配置，得确保你的测试类在匹配范围内，或者直接删掉这个过滤规则试试

3. 设备端的测试APK缓存/安装问题 #

有时候测试APK虽然构建出来了，但设备上的旧版本没清干净，导致运行的不是最新的测试APK：

• 先手动卸载设备上的主APK和测试APK：

  adb uninstall com.your.app.package
  adb uninstall com.your.app.package.test
  

• 然后清理构建缓存，重新运行测试：

  ./gradlew clean connectedAndroidTest
  

另外还要确认设备的API版本是否满足测试要求，比如某些AndroidX测试库要求设备API 21及以上，旧设备可能无法加载测试类

4. 测试依赖&目录结构是否正确 #

• 首先确认测试类放在了src/androidTest/java目录下！要是不小心放在src/test/java里，那是本地单元测试，connectedAndroidTest（Instrumented测试任务）是不会运行这些的
• 检查build.gradle里的Instrumented测试依赖是否正确添加，缺一不可：

  androidTestImplementation 'androidx.test.ext:junit:1.1.5'
  androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
  

  要是依赖缺失或者版本冲突，也会导致测试运行器无法识别测试类

5. 测试类命名规则（非强制但容易踩坑） #

虽然JUnit没有强制要求，但部分构建工具默认会过滤命名不符合规则的测试类，比如测试类最好以Test结尾（比如MainActivityTest），如果你的测试类叫MainActivityChecker之类的，可能会被默认过滤掉。可以在build.gradle里配置规则来覆盖：

android {
    testOptions {
        unitTests.all {
            filter {
                includeTestsMatching "*Test*" // 匹配包含Test的类/方法
            }
        }
    }
}

建议你先从「注解是否正确」和「测试类所在目录」这两个方向排查，这俩是我碰到最多的情况！

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