Go filepath.WalkDir 遇到权限错误时如何继续其他目录

用 filepath.WalkDir 扫描上传目录、备份目录或代码仓库时，某个子目录没有读取权限，并不代表其他目录也无法处理。关键在于：先处理回调传入的 err，确认它是否属于权限错误，再决定返回 filepath.SkipDir、nil，还是把错误继续返回。目录错误跳过子树，文件错误只放过当前文件，非预期错误则保留中止信号。

先判断 WalkDir 回调拿到的错误属于哪一层

WalkDir 会把根目录和遍历到的每个文件、目录交给 fs.WalkDirFunc。当访问路径失败时，回调收到的 err 描述这次失败；如果连路径自身的状态都取不到，d 可能是 nil。因此错误分支必须放在所有 d.IsDir()、d.Name() 之前。

还要区分“遍历器无法进入目录”和“某个文件无法读取”。前者适合跳过当前子树，后者通常只应记录并继续兄弟文件。不要因为一个文件报权限错误，就让整个父目录剩余内容都被跳过。

用 SkipDir 跳过不可读子树，遍历继续

下面的处理器只对权限类目录错误返回 filepath.SkipDir。遇到权限错误但 d 不是目录时返回 nil，表示放过当前文件；其他错误原样返回，让上层知道扫描没有完整结束。

package main

import (
    "errors"
    "fmt"
    "io/fs"
    "path/filepath"
)

func visitTree(root string) error {
    return filepath.WalkDir(root, func(path string, d fs.DirEntry, err error) error {
        if err != nil {
            // 访问失败时 d 可能为空，先记录路径，不能直接调用 d.IsDir。
            fmt.Printf("skip %s: %v\n", path, err)

            if d != nil && d.IsDir() && errors.Is(err, fs.ErrPermission) {
                // 目录不可读：跳过整棵子树，但保留同级目录的遍历。
                return filepath.SkipDir
            }
            if errors.Is(err, fs.ErrPermission) {
                // 文件不可读：只忽略当前文件，不扩大跳过范围。
                return nil
            }
            // 非权限错误可能代表更严重的异常，交给调用方处理。
            return err
        }

        if d.IsDir() && d.Name() == ".cache" {
            // 明确不需要扫描的目录也只影响当前子树。
            return filepath.SkipDir
        }
        return nil
    })
}

这里的 errors.Is 比直接比较错误值更稳妥，因为底层错误可能经过包装。对于权限错误而 d == nil 的情况，返回 nil 也不会进入该路径；遍历器会继续回到父级处理其他条目，只是程序无法再根据 d 判断它是不是目录。

不要把“继续”写成无条件吞错

返回 nil 的含义是“这个回调已经处理完，可以继续”，不是“错误不存在”。生产代码至少应记录路径、错误类型和扫描批次，必要时累积跳过清单。这样最终可以区分两种结果：没有错误的完整扫描，以及跳过部分路径后的部分完成。

如果业务要求“任何目录都必须可读”，就不要使用上述宽松策略，而是直接返回错误；如果业务只是收集可读文件，则可以把权限错误计入告警，同时继续处理其余目录。边界要由业务目标决定，不能只看遍历器是否返回了 nil。

用三个检查点确认遍历结果

1. 入口检查：根目录本身不可访问时，记录根路径并让调用方收到失败。
2. 过程检查：统计成功处理数量、权限跳过数量和非权限失败数量。
3. 结束检查：只有非权限失败数量为零、且业务允许权限跳过时，才把结果标记为可用。

filepath.WalkDir 按词法顺序遍历，且不跟随符号链接。它适合做目录清单、文件发现和增量扫描，但不应该被误解为已经读取了每个文件内容。需要打开文件时，还要在自己的读取逻辑中独立处理权限与关闭资源。

相关问题

返回 filepath.SkipDir 会停止整棵目录树吗？

不会。对目录返回它只跳过当前目录及其子树，遍历仍会继续处理父目录下的其他条目；对非目录条目使用它则可能跳过该文件所在目录的剩余条目，所以文件错误通常返回 nil 更合适。

为什么不能直接把所有 err 都返回 nil？

这样会把磁盘故障、路径变化或其他非权限异常伪装成成功扫描。至少要记录并分类错误；只有业务明确允许部分结果时，才对可控的权限错误继续。

把错误处理放在回调最前面、把 SkipDir 限定在目录边界，再用统计和日志复查结果，就能在不牺牲其他目录的前提下处理局部权限问题。