Java Files.isSameFile 怎样判断两个路径是否指向同一文件

在 Java 文件处理里，“两个路径是不是同一个文件”不能只靠字符串比较来回答。相对路径、冗余目录名和符号链接，都可能让两个不同写法最后定位到同一个文件。真正需要判断文件实体时，直接使用 Files.isSameFile(pathA, pathB)。

官方文档：https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/file/Files.html

结论先说：Files.isSameFile 返回 true，表示两个 Path 定位到同一个文件；返回 false 表示不能判定为同一文件。两个 Path 对象本身相等时，方法可以不访问文件直接返回 true；其他情况可能访问两个文件，因此要处理 IOException。

先确认判断目标：路径相同不等于文件相同

常见误判有三种：比较路径字符串、调用 Path.equals，或者读取两个文件再比较内容。前两种只是在比较路径对象的表示，后一种判断的是内容一致；它们都不等于“两个目录项是否指向同一个文件实体”。

例如，一个路径写成绝对路径，另一个路径包含 ..；或者一个路径是符号链接、另一个路径是链接目标。此时应该把“输入路径”交给文件系统 provider 判断，而不是先猜测结果。

图1：Files.isSameFile 判断的是路径背后的文件身份，而不是只比较字符串。

最小写法：让 Files.isSameFile 返回判断结果

调用只需要两个 Path。下面的示例把正常结果和访问失败分开处理，适合放在文件去重、输入校验或资源映射前。

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;

public class SameFileCheck {
    public static boolean isSame(Path first, Path second) {
        try {
            // 交给文件系统判断两个路径是否定位到同一个文件实体。
            return Files.isSameFile(first, second);
        } catch (IOException ex) {
            // 文件不存在、权限不足或访问过程中出错时，不把异常伪装成普通 false。
            throw new IllegalStateException("无法判断文件身份", ex);
        }
    }

    public static void main(String[] args) {
        Path source = Path.of("data/report.csv");
        Path alias = Path.of("data/./report.csv");

        boolean same = isSame(source, alias);
        System.out.println("same file = " + same);
    }
}

这里的 IllegalStateException 只是示例策略。批处理程序可以记录失败并跳过当前条目，服务端程序也可以把 IOException 映射为明确的业务错误。关键是不要把“无法读取文件身份”和“确定不是同一个文件”混成一个布尔值。

拆开两个边界：相等 Path 与文件系统访问

Java SE 21 文档明确说明：如果两个 Path 对象相等，isSameFile 返回 true 时不检查文件是否存在；如果两个 Path 关联不同的文件系统 provider，则返回 false。除此之外，具体实现会检查它们是否定位到同一个文件，可能需要访问两个文件。

因此，下面这段代码的 Path.equals 只能作为快速的对象层比较，不能替换最终判断：

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;

public class SameFileBoundary {
    public static boolean locateSameFile(Path first, Path second) throws IOException {
        // equals 只说明两个 Path 的对象表示相等，不能覆盖别名和符号链接场景。
        if (first.equals(second)) {
            return true;
        }

        // 非相等路径交给 provider 判断，结果可能依赖实际文件和文件系统能力。
        return Files.isSameFile(first, second);
    }
}

不要把这段快速分支扩展成“先 exists，再比较字符串”的替代实现。文件可能在两次访问之间变化，而 exists 只回答存在性，不能回答两个路径是否指向同一个文件。

图2：相等 Path 可以直接成立，其余判断依赖 provider 与文件访问能力。

符号链接、异常与排障顺序

Files.isSameFile 的签名没有让调用者传入 LinkOption；符号链接如何参与判断由文件系统 provider 的同一文件语义决定。需要判断链接本身而不是链接目标时，应先明确这个业务目标，再选择专门读取链接属性的 API，不要把 NOFOLLOW_LINKS 想当然地传给 isSameFile。

排查一个结果异常的比较任务，可以按下面顺序看：

1. 确认两个 Path 是否来自同一个文件系统 provider。
2. 确认文件在比较时仍存在，并且当前进程有读取两个路径的权限。
3. 记录 IOException 的具体原因，不要直接改成返回 false。
4. 如果业务实际关心的是内容一致，改用内容比较；如果关心的是文件实体，保留 Files.isSameFile。

最后记住一个容易忽略的边界：官方文档描述的是“在文件系统和文件保持静态时”的等价关系。若文件在判断期间被替换、删除或重新创建，应用层仍应把结果和异常放在自己的并发与重试策略中处理。

常见问题

Files.isSameFile 能判断两个文件内容是否一样吗？

不能。它判断两个路径是否定位到同一个文件；两个不同文件即使内容完全相同，也不应据此返回 true。

Path.equals 和 Files.isSameFile 有什么区别？

Path.equals 比较 Path 对象表示，Files.isSameFile 让文件系统判断文件身份。别名、相对路径和符号链接场景下，两者结果可能不同。

为什么调用 Files.isSameFile 会抛 IOException？

非相等 Path 的判断可能需要访问两个文件；文件消失、权限不足、存储设备或 provider 访问失败时，都可能产生 IOException。应按业务记录、重试或上报，而不是静默吞掉。

总结

判断两个 Java 路径是否指向同一文件时，首选 Files.isSameFile。把 Path.equals 当成对象层快速判断，把文件系统访问结果和 IOException 当成真实边界；同时区分文件身份、文件内容和路径文本，才能让结果符合实际文件处理需求。