Java Files.exists(Path)在Linux失效但Windows正常的问题排查

核心原因 #

这个问题本质是相对路径解析依赖当前工作目录，结合Windows与Linux文件系统的大小写敏感性差异、Maven/IDE测试运行时的工作目录配置差异共同导致的。

1. 相对路径解析逻辑 #

Java中Paths.get("test")是基于**当前工作目录（CWD）**解析的，而非测试类位置、项目根目录或代码路径。test.toAbsolutePath()显示的是相对路径结合当前工作目录生成的绝对路径，但如果该路径在Linux下实际不存在，Files.exists()就会返回false。

2. 具体触发场景 #

场景一：大小写敏感性差异

Windows文件系统默认大小写不敏感，比如实际目录名为Test，代码中用test也能匹配；但Linux文件系统严格区分大小写，test与Test是完全不同的路径。如果你的项目在Windows下创建的目录是Test，同步到Linux后未修正目录名，代码中的test路径就会找不到对应目录。

场景二：测试运行的工作目录不一致

• Windows下IDE（如IntelliJ IDEA）默认可能将模块根目录作为测试工作目录，此时test指向模块下存在的test目录。
• Linux下IDE或Maven命令行执行时，工作目录可能是项目根目录，此时test指向项目根目录下不存在的test目录，你看到的toAbsolutePath()输出可能是IDE显示逻辑或临时操作导致的混淆。

解决方案 #

1. 验证目录名大小写 #

在Linux终端执行命令查看目标路径的实际目录名：

ls -l /home/user/pathToProject/directory/

若实际目录名是Test或其他大小写形式，修改代码中的路径字符串为完全匹配的名称，或统一目录名为小写test。

2. 使用基于项目根目录的绝对路径 #

避免依赖当前工作目录，通过Java代码获取项目根目录后拼接目标路径：

// 获取项目根目录（适配Maven项目结构）
Path projectRoot = Paths.get(System.getProperty("user.dir"));
// 拼接目标目录路径
Path testDir = projectRoot.resolve("test");
System.out.println(testDir + ":" + Files.exists(testDir));

3. 统一IDE工作目录配置 #

以IntelliJ IDEA为例：进入Run/Debug Configurations，找到对应JUnit测试配置，将Working directory设置为模块根目录（即/home/user/pathToProject/directory），确保Windows与Linux下工作目录一致。

4. 配置Maven Surefire插件指定工作目录 #

在项目pom.xml中配置Surefire插件，固定测试运行的工作目录：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.2.5</version>
            <configuration>
                <workingDirectory>${project.basedir}</workingDirectory>
            </configuration>
        </plugin>
    </plugins>
</build>

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