Go os.RemoveAll 删除只读目录时的错误处理方案

Go 里用 os.RemoveAll 清理临时目录时，遇到只读文件或目录不要直接循环重试。它会尽力删除并返回第一次遇到的错误；目标不存在时返回 nil，失败通常可以从 *os.PathError 里拿到具体路径。更稳妥的方案是：先确认目标路径受控，再按错误位置判断是父目录不可写、平台只读属性，还是路径已经被其他进程改变，最后只对允许的目录做一次受限修复和重试。

先判断 RemoveAll 到底失败在哪里

官方文档对 RemoveAll 的描述很关键：它会删除路径及其子项，能删多少先删多少，并返回遇到的第一个错误。也就是说，调用返回错误时，目录可能已经被部分清理，不能假设它仍是原样。os.IsNotExist 只说明目标当前不存在，不代表此前没有发生过部分操作。

只读项不能用一种修复方式覆盖所有系统

“只读目录”在不同系统上含义并不完全相同。Unix 中删除目录项通常看父目录的写权限与执行权限，单独给子文件加写权限未必有用；Windows 上文件的只读属性又可能让删除行为表现不同。因此代码应先保存原始错误，再在明确的临时目录边界内遍历需要处理的项。不要从用户输入直接拼接一个路径就递归改权限。

package cleanup

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

// RemoveTree 清理受控根目录；只允许对根目录下的条目做一次有限修复。
func RemoveTree(root string) error {
    if root == "" || root == string(filepath.Separator) {
        return errors.New("拒绝清理空路径或文件系统根目录")
    }

    // 第一次调用保留原始错误，便于判断是否发生了部分删除。
    firstErr := os.RemoveAll(root)
    if firstErr == nil || os.IsNotExist(firstErr) {
        return nil
    }

    var pathErr *os.PathError
    if !errors.As(firstErr, &pathErr) {
        return fmt.Errorf("清理目录失败: %w", firstErr)
    }

    // 只遍历受控根目录；遍历失败时不把权限修复扩散到其他路径。
    walkErr := filepath.WalkDir(root, func(path string, entry fs.DirEntry, err error) error {
        if err != nil {
            return err
        }
        if entry.IsDir() {
            // 目录需要可访问；具体删除权限仍取决于父目录。
            return os.Chmod(path, 0o700)
        }
        // 文件可写有助于处理部分平台的只读属性，但不是万能授权。
        return os.Chmod(path, 0o600)
    })
    if walkErr != nil {
        return fmt.Errorf("清理失败，原始路径=%s，修复遍历失败: %w", pathErr.Path, walkErr)
    }

    // 只重试一次，避免权限异常时形成无限循环。
    if retryErr := os.RemoveAll(root); retryErr != nil && !os.IsNotExist(retryErr) {
        return fmt.Errorf("清理失败，原始错误=%v，重试错误: %w", firstErr, retryErr)
    }
    return nil
}

这个示例的重点不是“给权限就一定能删掉”，而是把修复范围锁在 root 内，并限制为一次重试。生产代码还应把根目录来源、任务 ID 和首次错误写入结构化日志；如果根目录属于挂载卷、共享目录或其他服务，就应由调用方决定是否延后清理。

把清理结果交给调用方，而不是吞掉错误

临时目录清理常发生在请求结束、构建结束或后台任务收尾阶段。调用方至少要知道三件事：路径本来就不存在、第一次删除报错但重试成功、以及重试后仍有残留。可以返回包装后的错误，让上层按任务类型选择告警、重试或人工处理；不要写成 _ = os.RemoveAll(path)，否则磁盘持续增长时很难追责到具体任务。

还有一个边界：RemoveAll 不是事务。它没有“全部成功才提交”的回滚语义，删除中途进程退出也可能留下半棵目录树。对可重建的缓存目录，可以记录清理队列；对包含用户文件或业务数据的目录，则应先做业务层确认，避免把“清理失败”变成数据丢失。

常见问题

只把文件改成可写，为什么还是删除失败？

因为 Unix 删除目录项通常由父目录权限决定，子文件的 mode 只是其中一个因素；还要检查运行用户、父目录权限、所有权和挂载限制。

RemoveAll 返回错误后能不能马上再调用一次？

可以把它作为一次幂等补偿，但应先保存第一次错误并确认路径仍在受控根目录内。无限重试会掩盖权限配置问题，也可能造成日志噪声。

目标不存在时是否应该当成失败？

如果清理任务的目标是“最终不存在”，可以把 os.IsNotExist 视为成功；如果需要审计谁先删除了目录，则应单独记录这个状态，而不是简单吞掉全部错误。

实际排查时，先看 *os.PathError 指向的路径，再核对父目录与运行身份，最后才考虑受限 Chmod 和单次重试。这样既能处理跨平台的只读项，也不会把权限修复误当成通用删除权限。