Go os.DirEntry.Info 为什么读取目录元数据时可能报错

在 Go 中，os.ReadDir 或 fs.WalkDir 返回的 fs.DirEntry 不是完整的文件信息对象。它先提供名称、类型等轻量信息；只有调用 Info()，才会取得对应的 fs.FileInfo。因此，Info() 报错并不矛盾：目录项可能已经被删除或重命名，或者底层文件系统无法在此刻读取完整元数据。

官方资料：https://pkg.go.dev/io/fs#DirEntry

Info() 应当被当作一次可能失败的元数据读取。先用 Name()、IsDir() 或 Type() 做轻量判断，确实需要大小、权限和修改时间时再调用 Info()，并根据错误决定记录、跳过还是终止。

先区分 DirEntry 与 FileInfo

DirEntry 表示“从目录中读到的一项”，而 FileInfo 描述文件或子目录的完整属性。两者的职责不同：遍历目录、筛选名称或判断类型时，通常不需要立刻读取全部元数据；展示大小、权限、修改时间时，才需要调用 Info()。

按需调用 Info，并保留返回错误

最小写法是先读取目录项，再在需要完整属性的分支中调用 Info()。不要把 Info() 的错误丢给空的 _，也不要因为读取到名称就假设同一条目后续一定存在。

package main

import (
    "errors"
    "fmt"
    "io/fs"
    "os"
)

func main() {
    // 目录项先用于名称和类型筛选，避免无条件读取所有元数据。
    entries, err := os.ReadDir("./data")
    if err != nil {
        fmt.Println("读取目录失败:", err)
        return
    }

    for _, entry := range entries {
        // 轻量字段适合先做业务筛选，不代表 FileInfo 已经完整可用。
        if !entry.IsDir() {
            continue
        }

        // Info 可能触发新的元数据读取，必须保留并判断错误。
        info, err := entry.Info()
        if err != nil {
            if errors.Is(err, fs.ErrNotExist) {
                // 目录项在两次读取之间消失时，把它当作瞬时变化处理。
                fmt.Println("条目已不存在:", entry.Name())
                continue
            }
            // 其他错误可能代表权限或文件系统问题，交给上层决定是否终止。
            fmt.Println("读取元数据失败:", entry.Name(), err)
            continue
        }

        fmt.Println(entry.Name(), info.ModTime(), info.Mode())
    }
}

这段代码把“目录项存在”与“现在能取得完整元数据”拆成两个判断。Info() 返回成功后，FileInfo 才适合读取 Size()、Mode() 和 ModTime()；如果返回错误，当前条目的属性就不能继续当作可信输入。

为什么条目被删除或重命名后会报错

目录读取和元数据读取不是一个不可分割的动作。程序先拿到一个 DirEntry，另一个进程可能在随后删除或重命名对应文件。官方文档明确说明：如果条目在目录读取后被删除或重命名，Info() 可能返回可被 errors.Is(err, fs.ErrNotExist) 识别的错误。

这是一种正常的文件系统竞态，不应通过“先判断存在、再无条件读取”的方式假设环境静止。更稳妥的做法是让 Info() 成为最终读取动作，并按业务目的选择处理策略：

• 目录索引或清理任务：把 fs.ErrNotExist 当作条目已经离开当前扫描范围，记录后继续。
• 备份、归档或审计任务：记录路径和错误，必要时终止或返回不完整结果，避免把缺失元数据误报成成功。
• 用户界面展示：显示“条目已变化”或刷新目录，不要缓存上一轮的大小和修改时间冒充当前状态。

符号链接场景要看链接本身

如果 DirEntry 表示符号链接，Info() 返回的是链接本身的信息，而不是链接目标的信息。这个边界很重要：读取链接的模式、名称或其他属性，与读取目标文件的大小和修改时间不是同一个问题。

package main

import (
    "fmt"
    "io/fs"
    "os"
)

func describe(entry fs.DirEntry) {
    // Type 只帮助识别类型位；读取完整属性仍要调用 Info 并检查错误。
    if entry.Type()&os.ModeSymlink != 0 {
        fmt.Println("这是符号链接:", entry.Name())
    }

    // Info 描述链接本身，不自动改为目标文件的属性。
    info, err := entry.Info()
    if err != nil {
        fmt.Println("链接信息读取失败:", err)
        return
    }
    fmt.Println("链接模式:", info.Mode())
}

因此，业务代码需要先明确自己要保护的对象：如果关心的是目录项本身，使用 DirEntry.Info()；如果需要跟随链接查看目标，应该选择明确的路径读取策略，并单独处理目标不存在、权限不足和目标变化等错误。不要把两个语义混在一个“获取文件信息”的辅助函数里。

在 WalkDir 中决定继续、跳过还是停止

fs.WalkDir 把 DirEntry 传给 WalkDirFunc。回调收到的 err 是遍历目录本身的错误；回调内部调用 Info() 得到的错误，则是当前条目元数据读取错误。两者应分别判断，避免把一个条目的问题误当成整棵目录树都不可访问。

package main

import (
    "errors"
    "fmt"
    "io/fs"
    "os"
)

func main() {
    // WalkDir 只负责遍历；元数据策略由回调按当前任务决定。
    err := fs.WalkDir(os.DirFS("."), ".", func(path string, entry fs.DirEntry, walkErr error) error {
        if walkErr != nil {
            // 目录读取失败时，返回错误会让整个遍历停止。
            return walkErr
        }

        // 目录项本身仍可能在回调执行前后发生变化。
        info, err := entry.Info()
        if err != nil {
            if errors.Is(err, fs.ErrNotExist) {
                // 单个条目消失不影响其余路径，记录后继续扫描。
                fmt.Println("跳过已消失条目:", path)
                return nil
            }
            // 审计类任务可以选择把非预期元数据错误向上返回。
            return fmt.Errorf("读取 %s 的元数据: %w", path, err)
        }

        fmt.Println(path, info.Size())
        return nil
    })
    if err != nil {
        fmt.Println("遍历未完成:", err)
    }
}

这里的关键不是固定返回哪一种结果，而是先把错误分类：可接受的条目变化可以记录后继续；影响目录读取或审计完整性的错误，应返回给调用方。对于目录本身，WalkDir 还支持通过回调返回 fs.SkipDir 或 fs.SkipAll 控制后续范围，但它们解决的是遍历范围，不是让 Info() 忽略错误。

常见问题

Info() 会不会总是触发一次系统调用？

接口只保证返回对应的 FileInfo 或错误，具体实现可以使用目录读取时已有的信息，也可以在调用时重新读取。调用方不应依赖某一种系统调用次数，只应依赖返回值和错误。

Type() 能不能替代 Info()？

不能。Type() 只提供类型位，不能替代大小、权限和修改时间等完整属性。需要这些字段时仍要调用 Info()。

遇到 fs.ErrNotExist 是否一定要重试？

不一定。目录索引通常可以跳过；审计或备份任务可能需要记录并失败。重试前要确认业务真的需要一致快照，因为条目可能已经被新对象替换。

Info() 返回的 FileInfo 可以长期缓存吗？

只能把它看作某一时刻的描述。文件系统内容可能继续变化；如果后续动作要求当前状态，应在动作附近重新读取并再次处理错误。

总结来说，DirEntry 适合做目录遍历中的轻量判断，Info() 负责按需取得完整元数据，但它不是无错误的属性字段。把条目变化、符号链接语义和遍历策略分开处理，就能避免把一次目录扫描误写成静态快照。