GitLab流水线中getResource()访问空目录返回null，本地Gradle运行正常

问题描述 #

我有一个名为emptyFolder的空目录，本地通过Gradle运行以下代码时可正常工作：

this.getClass().getClassLoader().getResource(emptyFolder)

但在GitLab流水线中运行相同代码时，该方法返回null。运行前的所有任务日志一致：

> Task :compileJava NO-SOURCE
> Task :processResources NO-SOURCE
> Task :classes UP-TO-DATE
> Task :cleanTest
> Task :compileTestJava UP-TO-DATE
> Task :processTestResources UP-TO-DATE
> Task :testClasses UP-TO-DATE
> Task :test

若在emptyFolder中放入任意文件，GitLab流水线中的代码也能正常运行。问题仅出现在访问空目录时，为何本地运行无此问题？

核心原因：资源处理与类加载逻辑的环境差异 #

1. Gradle processResources任务的空目录处理规则 #

Gradle的processResources默认只会复制包含文件的目录到输出目录（如build/resources/main或build/resources/test）。本地环境能正常运行的原因通常是：

• 本地构建缓存或输出目录中，该目录曾有过文件，即使后续清空，空目录未被clean任务彻底删除，仍保留在类路径中；
• 部分操作系统/文件系统下，Gradle的文件复制逻辑会宽松保留空目录，而GitLab流水线使用的Linux容器环境中，Gradle严格遵循“不复制空目录”的规则。

2. 类加载器getResource的工作机制 #

getClassLoader().getResource()只能从类路径中查找资源，而类路径中的目录必须是被Gradle复制到输出目录的有效资源。如果空目录未被processResources复制，类路径中就不存在该目录，自然返回null。

本地运行时，空目录可能因缓存残留或环境规则被保留，所以类加载器能找到；而GitLab流水线是干净构建环境（通常会执行clean），空目录不会被复制到资源输出目录，导致查找失败。

3. 添加文件后正常的逻辑 #

当emptyFolder中有文件时，processResources会复制整个目录（包含文件）到输出目录，类路径中存在该目录，因此getResource()能正常定位到。

解决方法 #

• 强制复制空目录：在build.gradle中配置processResources（及processTestResources）任务，强制保留空目录：

  // 主资源目录配置
  processResources {
      from('src/main/resources') {
          include 'emptyFolder/**'
          includeEmptyDirs = true
      }
  }
  
  // 测试资源目录配置
  processTestResources {
      from('src/test/resources') {
          include 'emptyFolder/**'
          includeEmptyDirs = true
      }
  }
  

• 调整代码逻辑：避免依赖空目录的存在，改为处理目录不存在的场景，或通过其他方式判断目录逻辑。

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