Go fs.WalkDir 如何在遇到权限错误时保留其他目录

如果目录树里有一个文件夹没有读取权限，fs.WalkDir 不会自动替你“跳过并继续”。回调收到非空 err 后，返回原始错误会让遍历结束；想保留其他目录，应先记录错误，再返回 fs.SkipDir。同时要区分根路径无法打开、当前目录无法读取，以及普通的非权限错误。

这个处理方式的关键是：SkipDir 只跳过当前目录（如果当前回调对应的是文件，则跳过它所在的父目录），而返回其他非空错误表示整次 WalkDir 失败。下面用一个内存文件系统演示回调边界，真实项目中把 fsys 换成 os.DirFS 即可。

遇到权限错误想继续遍历时，不要直接 return err；把错误加入记录后 return fs.SkipDir。对根目录错误和无法识别的错误仍然返回原错误。

三个要点：回调里的 err 优先处理；errors.Is(err, fs.ErrPermission) 只判断权限语义；最终根据错误记录和访问列表一起判断结果。

为什么返回原始错误会让遍历提前结束

WalkDir 会先把根路径交给回调；对一个目录，它还会在尝试读取目录内容前调用一次，读取失败后再带着错误调用一次。也就是说，权限问题常见的表现是 d 仍然描述这个目录，但 err 已经非空，函数不会继续深入该目录。

回调返回值决定后续动作：返回 nil 表示接受当前状态；返回 fs.SkipDir 表示跳过当前目录；返回其他非空错误表示停止整次遍历。不能把“记录错误”和“终止遍历”混成同一个返回值。

用 SkipDir 留住后续目录

下面的示例把每个权限错误放进 permissionErrors，把正常进入回调的路径放进 visited。当 err 是权限错误时返回 fs.SkipDir，这样当前目录不再向下读取，同级的其他目录仍有机会被访问。

package main

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

func walkKeepingOtherDirs(fsys fs.FS) ([]string, []string, error) {
    var visited []string
    var permissionErrors []string

    err := fs.WalkDir(fsys, ".", func(path string, d fs.DirEntry, err error) error {
        if err != nil {
            // 先保留路径，便于报告哪个目录被跳过。
            if errors.Is(err, fs.ErrPermission) {
                permissionErrors = append(permissionErrors, path)
                return fs.SkipDir
            }
            // 根路径或其他未知错误不能静默吞掉。
            return err
        }
        // 只记录成功进入回调的路径，避免把失败原因混入访问结果。
        visited = append(visited, path)
        return nil
    })
    return visited, permissionErrors, err
}

func main() {
    // 示例使用当前文件夹；生产代码可替换为 os.DirFS("/srv/data")。
    visited, denied, err := walkKeepingOtherDirs(os.DirFS("."))
    fmt.Println(visited, denied, err)
}

示例故意把未知错误继续向上返回。这样“可预期的权限缺口”不会阻塞扫描，但文件系统损坏、实现错误或根路径不存在仍然会暴露出来。生产代码中不要把上面的空接口直接运行；应传入已经初始化的 fs.FS，例如 os.DirFS(root)。

把权限判断和其他错误分开

不要用错误字符串比较，例如判断是否包含“permission denied”。文件系统实现可能会用 PathError 包住底层错误，errors.Is 能沿着错误链判断 fs.ErrPermission，比字符串匹配稳定。

还有两个容易混淆的边界。第一，根路径的初始 Stat 失败时，回调里的 d 是 nil，此时返回 fs.SkipDir 会让整次遍历以“没有错误”的形式结束，所以通常应把根目录错误直接返回。第二，目录读取失败时，d 可能仍是目录项；是否跳过由错误语义决定，不要只看 d.IsDir()。

检查遍历结果是否符合预期

建议同时保留三类结果：成功回调的路径、被跳过的权限路径、最终返回值。权限列表非空但最终错误为 nil，说明采用了“尽力扫描”；最终错误非空，则说明存在不能忽略的故障。若调用方要求完整清单，还应把权限路径写进报告，而不是当作文件不存在。

最后记住 WalkDir 按字典序读取目录，并且默认不跟随目录中的符号链接。它解决的是遍历回调和错误控制，不会替你改变操作系统权限，也不会保证所有目录都可读取。

相关问题

为什么不直接返回 nil？返回 nil 会把当前错误当成已处理，可能让报告丢失；至少应先记录路径和错误。

fs.SkipAll 能代替 fs.SkipDir 吗？不能。SkipAll 会跳过剩余所有文件和目录，适合主动终止扫描，不适合只绕过一个权限受限目录。

什么时候应该让遍历失败？当根路径打不开、错误不是可接受的权限缺口，或业务要求完整读取时，应返回原错误并由上层决定重试、告警或退出。