Go filepath.EvalSymlinks 目标不存在时怎样区分错误

filepath.EvalSymlinks 的职责是把路径中的符号链接解析出来，并返回解析后的路径；目标不存在时，它不会替你“猜一个最终路径”，而是通过 error 报告失败。排查时不要用 strings.Contains(err.Error(), "not exist") 做判断，应该用 errors.Is(err, os.ErrNotExist) 区分明确的缺失分支，再把断链、权限不足和路径格式等情况交给其它分支处理。

先分清 EvalSymlinks 能做什么

官方文档对 filepath.EvalSymlinks 的定义很直接：它返回路径经过符号链接解析后的结果；相对路径通常仍相对于当前目录，除非某一段链接指向绝对路径，最终结果还会经过 Clean 处理。这里的关键词是“解析已有文件系统对象”，不是“对一个可能存在的路径做词法规范化”。

因此下面两类操作不能混在一起：

用 errors.Is 判断目标不存在

最小可用的判断方式是把错误分为“明确缺失”和“其它失败”。errors.Is 会沿着包装错误继续查找目标值，比直接比较错误字符串稳定；代码里还保留原始错误，方便日志记录和定位实际路径。

package main

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

func resolve(path string) (string, error) {
    resolved, err := filepath.EvalSymlinks(path)
    if err == nil {
        // 成功时返回已经解析过符号链接并 Clean 过的路径。
        return resolved, nil
    }

    if errors.Is(err, os.ErrNotExist) {
        // 目标缺失或链接断裂都可能落入这个分支，不能据此断言输入本身不是链接。
        return "", fmt.Errorf("目标不存在或链接已断裂 %q: %w", path, err)
    }

    // 保留原始错误链，调用方仍可用 errors.Is 或 errors.As 做更细判断。
    return "", fmt.Errorf("解析符号链接失败 %q: %w", path, err)
}

func main() {
    resolved, err := resolve("./config/current.yaml")
    if err != nil {
        // 这里输出分类后的业务错误，真实项目还应记录原始路径和请求上下文。
        fmt.Println(err)
        return
    }
    fmt.Println(resolved)
}

这段代码有一个容易被忽略的边界：符号链接本身存在，但它指向的目标已经删除时，解析也可能返回 os.ErrNotExist。这时“目标不存在”是正确的处理类别，但它不等同于“普通文件路径从未存在”。如果业务要给出更准确的提示，就要在解析失败前后检查链接自身，而不能只依赖一次 EvalSymlinks 的结果。

断链、权限和路径问题怎样分层

把所有错误都归为“文件不存在”会掩盖权限、挂载点和路径格式问题。可以把判断顺序固定成：先判断 os.ErrNotExist，再保留其它错误；只有在业务确实需要区分“链接存在但目标不在”时，才增加额外的 os.Lstat。

package main

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

type LinkState string

const (
    LinkResolved LinkState = "resolved"
    LinkMissing  LinkState = "missing-or-broken"
    LinkDenied   LinkState = "permission-or-io-error"
)

func inspectLink(path string) (LinkState, string, error) {
    resolved, err := filepath.EvalSymlinks(path)
    if err == nil {
        // 成功解析后再返回最终路径，避免调用方继续使用未解析的输入。
        return LinkResolved, resolved, nil
    }

    if errors.Is(err, os.ErrNotExist) {
        // Lstat 只检查链接目录项本身，不跟随链接，可帮助区分“链接存在但目标缺失”。
        if _, lstatErr := os.Lstat(path); lstatErr == nil {
            return LinkMissing, "", fmt.Errorf("链接存在但目标不可达 %q: %w", path, err)
        }
        return LinkMissing, "", fmt.Errorf("路径或链接不存在 %q: %w", path, err)
    }

    // 权限、IO 和平台相关错误保留在 error 链里，不强行改写成不存在。
    return LinkDenied, "", fmt.Errorf("无法读取符号链接 %q: %w", path, err)
}

func main() {
    state, target, err := inspectLink(filepath.FromSlash("config/current.yaml"))
    // 输出状态和解析结果，便于排障；生产日志应避免泄露敏感目录。
    fmt.Printf("state=%s target=%q err=%v\n", state, target, err)
}

Lstat 的作用是观察目录项本身，不跟随符号链接；它不能让断链变成可读文件，也不能替代最终的业务访问。上面的 LinkDenied 名称只是示例分类，实际项目可能还要把 os.ErrPermission、网络文件系统的 I/O 错误以及平台特有错误分成不同指标。

什么时候应该预检，什么时候直接执行

如果后续操作就是读取配置、打开数据文件或遍历目录，通常不需要为了“先证明存在”而增加一次预检。直接执行并检查最终操作的错误，可以减少检查与使用之间的竞态窗口。只有在界面提示、批处理汇总或需要区分断链的诊断命令中，预检 EvalSymlinks 才更有价值。

可以按下面的决策表安排：

几个容易误判的边界

第一，filepath.Clean 只做词法处理，不会访问文件系统，也不会验证符号链接。第二，EvalSymlinks 成功只代表解析到了一个路径，不等同于调用方随后拥有读取权限。第三，先 Lstat 再打开仍然存在竞态，真正使用时必须再次检查打开操作的错误。

跨平台排障时，日志建议至少保留原始输入、分类状态和包装错误；不要把绝对路径、用户目录或令牌写进公开文章、指标标签或对外响应。若路径来自用户输入，还应在业务层单独处理允许的根目录和链接逃逸问题，这与“目标不存在”是两套判断。

常见问题

EvalSymlinks 找不到目标时一定是普通文件不存在吗？

不一定。符号链接本身可能存在，但它指向的目标已经删除，形成断链；这类情况也可能通过 os.ErrNotExist 表达。要区分两者，可结合不跟随链接的 os.Lstat 做诊断。

为什么不能直接比较 err.Error()？

错误文本可能带有路径、平台差异和包装层次。用 errors.Is(err, os.ErrNotExist) 判断语义，再保留原错误用于日志，代码更稳定。

EvalSymlinks 成功后还要检查权限吗？

要。成功解析只说明链接可以被解析，后续读取仍可能因为权限、竞态或 I/O 故障失败；最终的打开或读取操作必须独立检查错误。