Android应用Gradle单元测试在Windows构建服务器失败，本地运行正常

核心问题定位 #

报错里的Error: Could not find or load main class Files\Common是关键——这说明路径包含空格但未被正确转义，比如JDK或Gradle安装在C:\Program Files\Common Files这类带空格的目录，启动测试执行器时命令行把空格当成了参数分隔符，导致把Files\Common当成了主类名，而非路径的一部分。本地环境因为配置或变量的引号处理正确，所以未触发该问题。

解决方案步骤 #

1. 修正JDK路径格式 #

• 若构建服务器的JDK安装在带空格的目录（如Program Files下），将JAVA_HOME环境变量替换为短路径格式：比如C:\Progra~1\Java\jdk-17（Progra~1对应Program Files，Progra~2对应Program Files (x86)）
• 或在项目根目录的gradle.properties中显式指定带引号的JDK路径：

  org.gradle.java.home="C:\Program Files\Java\jdk-17"
  

2. 调整测试任务的JVM参数 #

在AuthorizationModule/build.gradle中，给测试任务添加引号包裹的类路径参数：

test {
    jvmArgs = [
        "-cp", "\"${sourceSets.test.runtimeClasspath.asPath}\""
    ]
}

3. 修复环境变量的引号问题 #

• 检查系统环境变量中的PATH、GRADLE_HOME，确保带空格的路径都被双引号包裹
• 重启构建服务（如Jenkins、GitLab Runner），让环境变量生效

4. 强制使用Gradle Wrapper #

确保构建服务器执行项目自带的Gradle Wrapper，避免全局Gradle的路径空格问题：

./gradlew :AuthorizationModule:testQaDebugUnitTest

验证步骤 #

1. 在构建服务器执行echo %JAVA_HOME%，确认路径格式正确
2. 手动运行Gradle测试命令，观察主类找不到的报错是否消失
3. 重新触发CI/CD流水线，检查管道关闭的IOException是否随主类问题解决而消失（管道关闭通常是测试执行器启动失败的连锁反应）

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