如何判断java.nio.file.Path实例指向同一文件并实现线程同步？

问题背景 #

多线程环境下执行文件追加写入时，尝试用java.nio.file.Path实例作为同步锁的键，但发现不同字符串生成的Path（即使指向同一文件）equals()返回false，比如：

final Path a = Path.of("abc.java");
final Path b = Path.of("./abc.java");
System.out.println(a.equals(b)); // 输出false，但实际指向同一文件

由于synchronized依赖对象引用相等而非equals()，且Map<Path, V>/Set<Path>的唯一性依赖equals()，导致无法保证同一文件获取到同一个锁实例，进而无法正确同步。

惯用解决方案 #

方案一：基于规范化绝对路径的锁映射 #

将用户传入的Path转换为绝对且规范化的路径，消除相对路径、冗余符号（如./）的差异，确保所有指向同一文件的路径生成完全一致的Path实例。再用ConcurrentHashMap维护路径到锁对象的映射，保证同一文件对应同一个锁。

代码实现：

import java.nio.file.Path;
import java.nio.file.Files;
import java.nio.charset.StandardCharsets;
import java.nio.file.StandardOpenOption;
import java.util.concurrent.ConcurrentHashMap;

public class FileAppender {
    private final ConcurrentHashMap<Path, Object> fileLocks = new ConcurrentHashMap<>();

    public void appendToFile(Path path, String content) throws IOException {
        // 转换为绝对规范化路径，统一等价路径的表示
        Path normalizedPath = path.toAbsolutePath().normalize();
        // 原子性获取或创建锁对象，避免多线程重复创建
        Object lock = fileLocks.computeIfAbsent(normalizedPath, k -> new Object());
        
        synchronized (lock) {
            Files.write(
                normalizedPath,
                content.getBytes(StandardCharsets.UTF_8),
                StandardOpenOption.APPEND,
                StandardOpenOption.CREATE
            );
        }
    }
}

• 关键逻辑：toAbsolutePath().normalize()会处理相对路径、盘符大小写（Windows）等问题，确保等价路径生成相同的Path；ConcurrentHashMap.computeIfAbsent()是原子操作，避免多线程下重复创建锁对象。

方案二：使用FileChannel文件锁 #

利用Java NIO的FileChannel提供的文件级锁，直接基于实际文件而非路径实例实现同步，无需维护锁映射。该方案支持跨进程同步，同时也适用于进程内多线程场景。

代码实现：

import java.nio.file.Path;
import java.nio.channels.FileChannel;
import java.nio.channels.FileLock;
import java.nio.ByteBuffer;
import java.nio.charset.StandardCharsets;
import java.nio.file.StandardOpenOption;
import java.io.IOException;

public class FileAppender {
    public void appendToFile(Path path, String content) throws IOException {
        try (FileChannel channel = FileChannel.open(
                path,
                StandardOpenOption.WRITE,
                StandardOpenOption.APPEND,
                StandardOpenOption.CREATE
            )) {
            // 获取整个文件的独占锁，若需共享读可传入true作为第三个参数
            FileLock lock = channel.lock();
            try {
                // 将写入位置移到文件末尾
                channel.position(channel.size());
                channel.write(ByteBuffer.wrap(content.getBytes(StandardCharsets.UTF_8)));
            } finally {
                // 确保锁被释放，避免泄漏
                lock.release();
            }
        }
    }
}

• 注意事项：FileLock必须在finally块中释放；Windows系统的文件锁是强制性的，Linux则是建议性的，跨平台需注意差异；同一进程内FileChannel的锁是可重入的，多线程调用不会阻塞。

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