Go os.ReadFile遇到权限错误时的定位顺序

我处理 Go 配置文件读取失败时，最容易走偏的一步是看到 permission denied 就立刻改文件权限。os.ReadFile 返回的通常是带操作名和路径的 *os.PathError，真正有效的定位顺序应该是：先用错误语义判断是否不存在或被拒绝，再确认目标是不是目录，最后沿父目录和运行身份继续查。

官方文档：https://pkg.go.dev/os

Go os.ReadFile 的错误先按语义分类

os.ReadFile 负责打开并读取路径，失败时不要写 err.Error() == "permission denied" 这样的判断。不同系统的错误文本、包装层和路径格式都可能不同。官方文档建议新代码使用 errors.Is 配合 fs.ErrNotExist 或 fs.ErrPermission。

用 PathError 留住真正失败的操作

分类时可以同时用 errors.As 拿到 *os.PathError。它适合记录 Op 和 Path，便于发现“代码传入的相对路径并不是预期路径”；权限结论仍由 errors.Is 给出。

package main

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

func readConfig(path string) ([]byte, error) {
    data, err := os.ReadFile(path)
    if err == nil {
        return data, nil
    }

    var pathErr *os.PathError
    switch {
    case errors.Is(err, fs.ErrNotExist):
        // 文件和父目录缺失都先归入不存在，避免误改权限。
        return nil, fmt.Errorf("配置路径不存在: %w", err)
    case errors.Is(err, fs.ErrPermission):
        // 权限判断依赖错误语义，不依赖某个系统的英文文案。
        return nil, fmt.Errorf("配置读取被拒绝: %w", err)
    case errors.As(err, &pathErr):
        // PathError 提供操作和路径，适合记录排障上下文。
        if info, statErr := os.Stat(path); statErr == nil && info.IsDir() {
            // 目录不是普通文件，单独提示比笼统报读取失败更有用。
            return nil, fmt.Errorf("配置路径是目录: %s", path)
        }
        return nil, fmt.Errorf("读取 %s(%s) 失败: %w", pathErr.Path, pathErr.Op, err)
    default:
        // 保留未知错误，交给上层决定是否重试或终止。
        return nil, fmt.Errorf("读取配置失败: %w", err)
    }
}

这里的 Stat 只是补充诊断，不能把它当成永久锁定的事实：检查之后路径仍可能被替换。因此生产代码仍应保留原始错误，并避免根据一次检查结果执行危险的自动修复。

权限错误要沿着路径边界继续查

在类 Unix 系统里，读取文件至少涉及“进程能否穿过父目录”和“进程能否读取目标文件”两层。目标文件显示可读，但父目录没有执行（穿越）权限，ReadFile 依然可能失败。容器、systemd 服务和定时任务还经常使用不同的运行用户或工作目录。

因此我通常按这个顺序记录：实际路径（必要时先确认当前工作目录）、进程身份、父目录是否可穿越、目标文件模式或 ACL，最后再看容器挂载、共享目录和平台差异。Windows 的 ACL、网络共享和杀毒软件策略不能简单套用 Unix 的模式位。

把目录误当文件与路径不存在分开处理

配置项为空、拼接路径少了一段，常常会把目录路径传给 ReadFile。这和权限不足是两种修复方向：前者应修正配置或选择目录遍历 API，后者才需要回到身份和权限边界。排查时不要只打印 err，至少把经过清理的路径和 PathError.Op 写进日志；但不要把用户提交的敏感绝对路径无条件暴露到外部响应。

相关问题

为什么不建议只匹配 permission denied？

错误文本受操作系统和包装层影响，字符串匹配既脆弱又难以覆盖同义错误。用 errors.Is 才能表达错误语义。

errors.Is 和 os.IsPermission 怎么选？

旧代码可以继续使用 os.IsPermission，新代码优先使用 errors.Is(err, fs.ErrPermission)，它和现代错误包装更一致。

Stat 成功后就一定能 ReadFile 吗？

不一定。权限可能在两次调用间变化，文件也可能被替换；Stat 适合解释失败，不是读操作的授权保证。

把错误分类、路径类型和运行环境分成三层后，Go 的文件读取故障就不会停留在“权限不够”这句模糊提示上：先确认语义，再确认对象，最后确认谁在什么路径上下文中读取。