使用NOFOLLOW_LINKS调用Files.newInputStream处理软链接的异常疑问

问题场景 #

我想明确java.nio.file.Files.newInputStream结合java.nio.file.LinkOption.NOFOLLOW_LINKS处理软链接的预期行为，但官方文档未给出相关说明。我做了如下测试：

1. 创建普通文件与软链接：

touch file
ln -s file link

2. 编写代码尝试打开软链接的输入流并指定NOFOLLOW_LINKS：

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

public class Main {
    public static void main(String[] args) throws IOException {
        try (
            InputStream stream = Files.newInputStream(Path.of("src", "link"), LinkOption.NOFOLLOW_LINKS)
        ) {}
    }
}

执行后抛出错误：

Exception in thread "main" java.io.IOException: Too many levels of symbolic links (NOFOLLOW_LINKS specified)
    at java.base/sun.nio.fs.UnixException.translateToIOException(UnixException.java:86)
    at java.base/sun.nio.fs.UnixException.rethrowAsIOException(UnixException.java:111)
    at java.base/sun.nio.fs.UnixException.rethrowAsIOException(UnixException.java:116)
    at java.base/sun.nio.fs.UnixFileSystemProvider.newByteChannel(UnixFileSystemProvider.java:219)
    at java.base/java.nio.file.Files.newByteChannel(Files.java:371)
    at java.base/java.nio.file.Files.newByteChannel(Files.java:422)
    at java.base/java.nio.file.spi.FileSystemProvider.newInputStream(FileSystemProvider.java:420)
    at java.base/java.nio.file.Files.newInputStream(Files.java:156)
    at Main.main(Main.java:10)

若移除NOFOLLOW_LINKS选项，或直接打开普通文件，则不会报错。我疑惑的是：如果NOFOLLOW_LINKS不适用于软链接场景，为何抛出的是带有"Too many levels of symbolic links"信息的IOException，而非IllegalArgumentException或UnsupportedOperationException？使用环境为OpenJDK 11.0.19。

原因解析 #

这个异常是底层Unix文件系统错误的直接映射，而非Java API的参数校验问题，具体逻辑如下：

1. NOFOLLOW_LINKS的作用：该选项指示文件系统不解析路径中的符号链接，直接操作链接本身。但输入流的核心目的是读取文件内容，而软链接本身只是指向目标文件的指针，没有可读取的实际数据。

2. 系统调用的行为逻辑：在Unix系统中，当调用open系统调用并指定O_NOFOLLOW标志（对应Java的NOFOLLOW_LINKS）时，若路径的最后一个组件是符号链接，系统会返回ELOOP错误码，对应的错误信息就是"Too many levels of symbolic links"。Java的NIO层仅将这个系统级错误转换为IOException，未额外添加参数合法性判断。

3. 为何不抛出参数类异常：NOFOLLOW_LINKS本身是合法选项，可用于其他场景（比如查询软链接的属性），只是在打开输入流读取内容这个场景下，底层系统不允许直接读取软链接对象。Java API遵循"底层错误直接映射"的设计原则，因此抛出系统错误对应的IOException，而非参数类异常。

预期行为总结 #

• 当使用Files.newInputStream搭配NOFOLLOW_LINKS打开软链接时，由于软链接无实际内容且选项禁止解析到目标文件，底层系统返回ELOOP错误，Java将其转为带对应信息的IOException。
• 移除该选项后，系统自动解析软链接到目标文件，可正常打开输入流。

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