如何用Java列出目录下所有文件（含无效文件如断链）

Java标准库中的File.listFiles()方法会自动过滤掉损坏的符号链接等被判定为“无效”的文件条目，导致无法获取完整的目录内容。要解决这个问题，推荐使用Java NIO的Files.list()方法，它能枚举目录下的所有条目，包括损坏的符号链接，且无需外部依赖，完美支持POSIX系统（Linux、macOS），同时具备跨平台兼容性。

解决方案代码 #

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

public class ListAllDirectoryEntries {
    public static void main(String[] args) {
        // 遍历当前目录下的所有条目
        try (var pathStream = Files.list(Paths.get("."))) {
            pathStream.forEach(path -> {
                System.out.println(path.getFileName());
            });
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

原理说明 #

• Files.list(Path)方法直接枚举目录中的每个条目，不会检查符号链接的目标是否存在，因此损坏的符号链接会被正常列出。
• 传统的File.listFiles()在底层会尝试获取每个文件的属性信息，对于损坏的符号链接，由于无法解析目标路径，会被判定为“无效”并过滤掉，这就是测试中看不到broken_link的原因。

验证结果 #

按照以下步骤测试：

1. 创建测试文件：

# 创建损坏的符号链接
ln -s /nonexistent/path $PWD/broken_link

# 创建有效的符号链接
ln -s /path/to/existing/file $PWD/working_link

# 创建普通空文件
touch empty_file

2. 运行上述Java代码，输出结果将包含所有三个条目（顺序不限）：

broken_link
working_link
empty_file

内容的提问来源于stack exchange，提问作者Jakub S.