Gradle配置下无法访问子文件夹资源文件问题求助

核心原因分析 #

你遇到的问题本质是IntelliJ默认运行环境与Gradle运行环境的classpath资源处理逻辑差异，结合场景具体原因如下：

1. 资源路径写法错误（针对ClassLoader加载方式） #

使用ClassLoader.getResourceAsStream()时，路径必须是相对于classpath根目录的相对路径，不能以/开头。你尝试的"/icon/app.png"是错误写法，ClassLoader会将其视为无效路径；而"icon/app.png"才是正确的相对路径写法，但如果Gradle的资源复制或classpath配置有问题，依然会加载失败。

2. Gradle资源复制规则异常 #

Gradle默认会将src/main/resources下的所有文件（包括子目录）复制到build/resources/main目录，该目录会被加入运行时classpath。如果build/resources/main下没有icon/app.png，说明：

• 你的build.gradle中可能存在自定义的资源过滤规则（比如exclude 'icon/**'），导致icon目录被排除；
• Gradle缓存未更新，旧的build目录没有同步最新的资源文件。

3. JavaFX Gradle插件的classpath配置差异 #

使用org.openjfx.javafxplugin插件时，run任务的classpath结构可能与IntelliJ默认运行环境略有不同，导致ClassLoader加载子目录资源时出现路径解析问题。

解决步骤 #

1. 验证资源是否被正确复制 #

执行Gradle的processResources任务，然后查看项目根目录下的build/resources/main文件夹：

• 如果不存在icon目录或icon/app.png，检查build.gradle中的sourceSets配置，确保没有排除该目录：

  // 错误示例：会排除icon目录，需删除此配置
  sourceSets {
      main {
          resources {
              exclude 'icon/**'
          }
      }
  }
  

2. 改用更可靠的资源加载方式 #

推荐使用Class.getResourceAsStream()替代ClassLoader的方法，这种写法在两种运行环境下都能稳定工作：

// 从classpath根目录加载icon/app.png，路径必须以/开头
ResourceHelper.class.getResourceAsStream("/icon/app.png")

该方法的逻辑是：带/的路径直接从classpath根目录查找，不带/则从当前类所在的包路径查找，避免了不同运行环境的classpath解析差异。

3. 清理Gradle缓存与build目录 #

如果资源已正确复制但仍加载失败，执行以下命令清理缓存：

# Linux/macOS
./gradlew clean

# Windows
gradlew.bat clean

清理后重新运行Gradle的run任务，确保使用最新的资源文件。

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