Java Files.readAttributes 怎样一次读取文件的基本属性

如果代码需要同时判断文件类型、读取大小并拿到多个时间字段，逐个调用 Files.isRegularFile、Files.size 和时间方法会让意图变散。更紧凑的写法是调用 Files.readAttributes(path, BasicFileAttributes.class)，让返回的属性对象承载这一组信息。

官方地址：https://docs.oracle.com/en/java/javase/26/docs/api/java.base/java/nio/file/Files.html

Java 的 Files.readAttributes 适合一次读取同一个路径的基本属性。默认情况下符号链接会跟随到目标文件；如果要读取链接自身，则传入 LinkOption.NOFOLLOW_LINKS。调用方仍然要处理 IOException，并把它和“路径不存在”区分开。

为什么用一次批量读取

BasicFileAttributes 是 Java NIO 提供的基本属性视图，包含文件类型判断、大小、最后修改时间、最后访问时间、创建时间和文件键等信息。它比把多个零散的查询拼在一起更容易表达“针对同一个路径读取一组元数据”的意图。

方法签名的核心部分如下：

// 传入路径和属性类型，返回对应的类型安全属性对象
BasicFileAttributes attrs = Files.readAttributes(
        path,
        BasicFileAttributes.class
);

这里的第二个参数不是属性名称字符串，而是属性视图的 Class 对象。读取基本属性时使用 BasicFileAttributes.class，需要 POSIX 属性时才考虑相应的专用视图。

用 BasicFileAttributes 读取常用字段

拿到属性对象后，类型、大小和时间字段都从同一对象读取。下面的示例把“普通文件”和“目录”分开处理，并在 I/O 失败时保留异常上下文：

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

public class FileAttributeReader {
    public static void printBasicAttributes(Path path) {
        try {
            // 一次获取同一路径的基本属性，避免把多个独立查询散落在业务代码里
            BasicFileAttributes attrs = Files.readAttributes(
                    path,
                    BasicFileAttributes.class
            );

            // 先判断类型，再按需读取大小和时间；目录的 size 不代表目录下所有文件的总和
            System.out.println("regular=" + attrs.isRegularFile());
            System.out.println("directory=" + attrs.isDirectory());
            System.out.println("size=" + attrs.size());
            System.out.println("modified=" + attrs.lastModifiedTime());
            System.out.println("created=" + attrs.creationTime());
        } catch (IOException e) {
            // 文件被删除、权限不足或底层文件系统访问失败，都应交给调用方决定如何处理
            throw new IllegalStateException("读取文件属性失败: " + path, e);
        }
    }
}

size() 返回字节数；对目录来说，它是文件系统报告的目录项大小，不是递归统计结果。creationTime() 和 lastAccessTime() 的精度、是否有意义，也取决于底层文件系统。

符号链接默认读取目标文件

如果 path 指向符号链接，readAttributes 默认会跟随链接，读取最终目标的属性。这个默认行为适合“把链接当成目标文件使用”的业务，但在清理、审计或链接管理场景中，调用方往往需要观察链接本身。

此时传入 LinkOption.NOFOLLOW_LINKS：

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.LinkOption;
import java.nio.file.Path;
import java.nio.file.attribute.BasicFileAttributes;

public class LinkAttributeReader {
    public static BasicFileAttributes readLinkItself(Path path) throws IOException {
        // NOFOLLOW_LINKS 让属性读取停留在符号链接本身，而不是跳到目标文件
        return Files.readAttributes(
                path,
                BasicFileAttributes.class,
                LinkOption.NOFOLLOW_LINKS
        );
    }
}

两种策略的选择不是性能开关，而是数据语义的选择：默认策略回答“目标文件是什么”，NOFOLLOW_LINKS 回答“这个链接对象是什么”。

IOException 和 UnsupportedOperationException 怎么区分

读取失败时首先要区分两类问题：

• IOException 表示这次访问文件属性时发生了 I/O 问题，例如路径不可读、权限不足或文件系统访问失败。
• UnsupportedOperationException 表示请求的属性类型或属性视图不被当前文件系统支持。读取基本属性时，标准实现都支持 BasicFileAttributes；使用更专用的视图时才更需要留意这个边界。

不要把 Files.exists(path) 的返回值当成读取前的绝对保证。存在性判断和后续属性读取之间可能发生文件删除、权限变化或挂载变化；如果业务必须拿到属性，就直接读取并处理异常。

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

public class AttributeBoundary {
    public static BasicFileAttributes tryRead(Path path) {
        try {
            // 直接以读取动作作为最终判断，避免把 exists 结果误当成后续访问保证
            return Files.readAttributes(path, BasicFileAttributes.class);
        } catch (IOException e) {
            // 记录路径后交给上层决定重试、跳过还是提示用户
            System.err.println("属性读取失败: " + path);
            return null;
        } catch (UnsupportedOperationException e) {
            // 专用属性视图不支持时不要伪造默认值，应该降级到受支持的视图或结束任务
            System.err.println("属性视图不受支持: " + path);
            return null;
        }
    }
}

和单字段方法怎样选择

如果只需要一个简单布尔判断，单字段方法更直接；如果后面还要读取多个属性，批量读取可以让异常处理和路径语义集中在一个位置。

使用时的速查结论

1. 使用 BasicFileAttributes.class 获得基本属性对象。
2. 通过 isRegularFile()、isDirectory() 判断类型，通过 size() 和时间方法读取字段。
3. 默认跟随符号链接；需要链接自身时传入 LinkOption.NOFOLLOW_LINKS。
4. 把 IOException 当作真实访问失败处理，不用 exists 预检查代替最终读取。
5. 使用专用属性视图前确认文件系统支持情况，不要用默认值掩盖 UnsupportedOperationException。

相关问题

Files.readAttributes 会递归读取目录吗？ 不会。它只读取传入路径对应对象的一组属性；递归遍历需要另外使用目录遍历 API。

NOFOLLOW_LINKS 会把链接目标属性返回吗？ 不会。该选项表示不跟随链接，读取的是符号链接自身的属性。

BasicFileAttributes 的创建时间一定可用吗？ 不一定。返回的时间精度和底层文件系统能力有关，业务不应把它当成所有平台都具备相同语义的字段。