Jenkins执行AWS Device Farm测试时无法读取config.properties且应用启动失败（手动上传正常）

我之前在Jenkins集成AWS Device Farm时也踩过这个坑，手动上传一切正常，但通过Jenkins跑就找不到config.properties，应用直接启动失败。大概率是构建或上传环节的文件路径、打包逻辑出了问题，给你几个具体的排查和解决方向：

1. 检查Jenkins构建是否把config.properties打包进了测试包 #

手动上传时你肯定确保了文件在正确位置，但Jenkins的构建脚本（Maven/Gradle）可能没把这个文件包含到最终上传的artifact里。比如Java/Android测试中，config.properties通常需要放在src/main/resources或src/test/resources目录，并且构建工具要同步打包这个目录的文件。

解决办法： #

• Maven项目：在pom.xml里确认资源文件配置：

<build>
  <resources>
    <resource>
      <directory>src/main/resources</directory>
      <includes>
        <include>config.properties</include>
      </includes>
    </resource>
    <!-- 如果是测试用的配置，还要加testResources -->
    <testResource>
      <directory>src/test/resources</directory>
      <includes>
        <include>config.properties</include>
      </includes>
    </testResource>
  </resources>
</build>

• Gradle项目：在build.gradle里配置sourceSets：

sourceSets {
    main {
        resources {
            include 'config.properties'
        }
    }
    test {
        resources {
            include 'config.properties'
        }
    }
}

构建完成后，解压Jenkins生成的测试包，确认config.properties是否在正确的位置（比如resources目录或测试类的classpath下）。

2. 检查测试代码的文件读取路径是否正确 #

手动上传时的文件结构可能和Jenkins生成的不一样，导致硬编码的路径在Jenkins场景下失效。比如你手动上传时config.properties在根目录，但Jenkins打包后放在了子目录里。

解决办法： #

避免硬编码路径，改用类加载器读取（从classpath加载），这种方式更可靠：

// Java示例
InputStream configStream = getClass().getClassLoader().getResourceAsStream("config.properties");
if (configStream == null) {
    throw new RuntimeException("config.properties not found in classpath");
}
Properties props = new Properties();
props.load(configStream);

这种方式只要config.properties在classpath里，不管包结构怎么变，都能读到。

3. 排查Jenkins构建时的变量替换是否破坏了config.properties #

有些Jenkins流水线会对config.properties做变量替换（比如把${ENV_URL}换成实际的环境地址），如果替换失败（比如变量不存在、替换语法错误），会导致文件内容损坏或为空，测试代码读取时出错。

解决办法： #

• 查看Jenkins构建日志，检查变量替换步骤的输出，确认替换后的文件内容是否正常。
• 在Jenkins构建后，直接查看生成包内的config.properties内容，和手动上传的版本做对比，看是否有差异。

4. 检查Jenkins上传到Device Farm的参数是否正确 #

手动上传时你在控制台选对了测试类型和artifact组合，但Jenkins用插件或AWS CLI上传时，可能漏传了包含config.properties的资源文件，或者上传的artifact不完整。

解决办法： #

• 如果用AWS Device Farm Jenkins插件：确认插件配置里的测试包和依赖资源都正确上传，比如如果config.properties在单独的资源包里，要把这个包也添加到上传列表。
• 如果用AWS CLI上传：确认aws devicefarm create-upload命令包含了所有必要的文件，并且在创建测试运行时关联了正确的上传资源。

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