Kotlin构建问题：资源文件未复制到target/classes目录如何解决？

碰到Kotlin项目里ehcache.xml、logback.xml这类资源文件没能复制到target/classes目录的问题，我太熟悉了！这通常和构建配置或者项目结构有关，下面给你几个靠谱的排查和解决方法：

标准的Gradle（Kotlin项目最常用的构建工具）项目结构中，资源文件必须放在src/main/resources目录下，比如你的两个xml文件要直接放在这个文件夹里（如果是自定义子目录，需要额外配置路径）。如果放错了位置（比如直接放在src/main/kotlin或者根目录），Gradle默认不会识别并复制它们到target/classes。

如果你的项目用的是Kotlin DSL（build.gradle.kts），先看看有没有修改过sourceSets或者资源处理的任务配置：

• 如果你手动配置了sourceSets，务必确保没有遗漏资源目录的声明。比如下面的配置是正确的：

  sourceSets {
      main {
          java {
              srcDirs("src/main/kotlin")
          }
          resources {
              srcDirs("src/main/resources") // 必须明确指定资源目录
          }
      }
  }
  

  如果只配置了java部分而没写resources，Gradle可能会忽略默认的资源路径。
• 还要检查processResources任务有没有错误的排除规则。比如如果有类似这样的代码：

  tasks.processResources {
      exclude("**/*.xml") // 这会把所有xml文件都排除！
  }
  

  赶紧删掉这条规则，或者修改成只排除你不需要的文件，别误伤了ehcache.xml和logback.xml。

有时候target目录里的旧缓存文件会干扰新资源的复制，试试这两步：

• 先执行清理任务：./gradlew clean（Windows系统用gradlew.bat clean），彻底清空target目录。
• 再执行资源处理任务：./gradlew processResources，或者直接构建项目：./gradlew build，确保资源文件被重新复制到target/classes。

如果你用IntelliJ IDEA作为开发工具，可能是IDE的目录标记出了问题：

• 右键点击src/main/resources目录，选择Mark Directory as -> Resources Root，让IDEA识别这是资源目录。
• 检查IDEA的Build, Execution, Deployment -> Build Tools -> Gradle设置，确保选中的是Gradle wrapper (recommended)，避免IDE自己的构建工具和Gradle配置不一致。

如果你的项目是多模块结构，要确认资源文件是放在对应子模块的src/main/resources下，而不是根项目的目录里。同时，子模块的build.gradle.kts也要保证资源配置正确，别继承了根项目的错误设置。

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