在 IntelliJ IDEA 的 Gradle 多模块项目中，测试资源文件（如 src/test/resources/file.txt）不应通过绝对路径或 IDE 自动生成的“复制路径”引用，而应基于类路径（Classpath）或模块结构相对定位，推荐使用 Class.getResource() 或 ClassLoader.getResource() 加载，确保跨环境可移植。
在 intellij idea 的 gradle 多模块项目中，测试资源文件（如 `src/test/resources/file.txt`）不应通过绝对路径或 ide 自动生成的“复制路径”引用，而应基于类路径（classpath）或模块结构相对定位，推荐使用 `class.getresource()` 或 `classloader.getresource()` 加载，确保跨环境可移植。
在 Gradle + IntelliJ IDEA 的标准项目结构中，src/test/resources/ 下的文件会被自动包含在测试类路径（test classpath）中——这是关键前提。直接硬编码类似 Path.of("src\test\resources\file.txt") 虽在本地开发时偶然生效（如提问者所用），但本质上是错误且不可靠的：它依赖源码目录结构而非构建产物，会导致测试在命令行（./gradlew test）、CI 环境或打包后失败，因为此时 src/ 目录并不存在于运行时 classpath 中。
✅ 正确做法：利用 JVM 类加载机制读取资源
资源应视为“类路径资源”（classpath resource），而非文件系统路径。推荐以下两种健壮方式：
1. 使用 Class.getResource()（推荐用于同包或子路径资源）
// 假设 TestClass 在包 com.example.utils 下
URL resourceUrl = TestClass.class.getResource("/file.txt"); // 注意开头的 '/' 表示根 classpath
// 或相对路径（若 file.txt 与 TestClass 同级或在子目录）：
// URL resourceUrl = TestClass.class.getResource("file.txt");
if (resourceUrl != null) {
Path path = Paths.get(resourceUrl.toURI());
String content = Files.readString(path, StandardCharsets.UTF_8);
}
2. 使用 ClassLoader.getResource()（更通用，从 classpath 根开始查找）
InputStream is = TestClass.class.getClassLoader().getResourceAsStream("file.txt");
if (is != null) {
try (InputStreamReader reader = new InputStreamReader(is, StandardCharsets.UTF_8)) {
String content = new String(is.readAllBytes(), StandardCharsets.UTF_8);
}
}
⚠️ 注意事项：
- src/test/resources/ 中的文件在编译后会复制到 build/resources/test/，并被添加到测试 classpath —— 这才是运行时真正可用的路径。
- IntelliJ 的“Copy Path/Reference”功能生成的是开发时的文件系统路径（如 project/utilities/src/test/resources/file.txt），不是运行时 classpath 路径，故不可直接用于 Paths.get()。
- 若必须使用 Path（例如需 Files 工具类操作），务必通过 getResource().toURI() 转换，避免硬编码路径分隔符（\ 或 /）。
- Gradle 配置需确保资源目录被正确识别：检查 build.gradle 中是否包含 sourceSets.test.resources.srcDirs = ["src/test/resources"]（默认已配置，通常无需修改）。
总结：永远优先选择基于 classpath 的资源加载方式，而非文件系统路径。这不仅解决当前问题，更保障测试在不同构建环境（IDE、Gradle CLI、CI/CD）中的一致性与可移植性。
