Go filepath.EvalSymlinks 后为什么路径仍可能变化

如果你发现 Go 中同一个路径先后经过 filepath.EvalSymlinks 后仍然不一样，通常不是 API “解析失败”，而是你把路径字符串、当前工作目录和文件系统对象当成了同一件事。EvalSymlinks 会解析调用时存在的符号链接，并对结果执行 Clean；只要链接目标、相对路径的基准目录或链接链发生变化，返回值就可能变化。

区分字符串变化与文件系统目标变化

先看一个常见场景：部署目录里有 current 符号链接，发布时把它从 releases/2026-09-08 切换到 releases/2026-09-09。对 current/config.yaml 调用两次 EvalSymlinks，得到的结果自然可能不同。这个结果是正确的，因为函数返回的是“此刻沿着链接解析后的路径”。

因此，日志里的“路径变化”至少有两种：返回的字符串变了，或者字符串没变但文件内容被替换了。前者可以由符号链接重指向造成，后者则需要继续看文件信息、打开句柄或应用层版本号。仅比较解析后的字符串，不能证明两次读取一定针对同一个文件对象。

拆开相对路径、绝对链接和 Clean 的影响

官方文档对这个函数的描述有一个容易漏掉的条件：输入是相对路径时，结果通常相对于当前目录；但如果路径中的某个符号链接是绝对目标，解析结果可能跳到绝对目标所在位置。也就是说，EvalSymlinks("current/config.yaml") 的结果不仅取决于字符串，还取决于进程当前目录以及每一级链接的内容。

Clean 只做词法整理，例如合并重复分隔符、消除 . 和可消除的 ..。它不会替你读取文件系统，也不会把符号链接目标解析出来。类似地，filepath.IsLocal 只进行词法分析，官方文档明确说明它不考虑符号链接的影响。把这几个 API 串在一起时，必须知道每一步解决的不是同一个问题。

为路径比较选择稳定的业务边界

如果目标只是展示路径或生成日志，filepath.Abs 加 Clean 往往就够了；如果目标是比较符号链接解析后的目录，可以先固定工作目录，再调用 EvalSymlinks。如果目标是判断用户输入是否落在某个资源目录内，则不能只用字符串前缀，更不能把 IsLocal 当成“已经穿过符号链接检查”。

业务上可以按下面的边界选方案：

用一个小型 helper 固化判断流程

下面的 helper 适合“我想记录解析后的绝对路径，并顺便确认目标仍可读取”的场景。它没有把路径伪装成永久 ID，错误也保留了输入信息，方便定位到底是解析失败还是读取失败。

package main

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

// resolveTarget 固定基准目录，并返回解析后的路径与目标信息。
func resolveTarget(baseDir, input string) (string, os.FileInfo, error) {
    // Join 会先把用户输入放入明确的业务基准下。
    candidate := filepath.Join(baseDir, input)
    resolved, err := filepath.EvalSymlinks(candidate)
    if err != nil {
        return "", nil, fmt.Errorf("解析 %q 失败: %w", candidate, err)
    }

    // Stat 读取当前目标信息；它不是对未来访问的锁定。
    info, err := os.Stat(resolved)
    if err != nil {
        return resolved, nil, fmt.Errorf("读取目标 %q 失败: %w", resolved, err)
    }
    return resolved, info, nil
}

func main() {
    resolved, info, err := resolveTarget("/srv/app", "current/config.yaml")
    if err != nil {
        fmt.Println(err)
        return
    }
    fmt.Printf("目标=%s，目录=%t，大小=%d\\n", resolved, info.IsDir(), info.Size())
}

这个示例把“输入基准”“符号链接解析”“目标信息读取”分开，便于替换成更严格的打开策略。生产代码还要考虑目录在两次系统调用之间被替换的情况：如果安全性要求高，应优先采用平台支持的受约束打开方式，并围绕已打开的句柄完成后续操作。

常见问题

EvalSymlinks 会把相对路径变成绝对路径吗？

不一定。相对输入通常仍相对于当前目录返回；只有解析链中出现绝对符号链接等情况，结果才可能转为绝对位置。需要绝对路径时，先明确调用 Abs 的业务意图。

先 Clean 再 EvalSymlinks 能解决路径不稳定吗？

不能。Clean 只整理字符串，不能代替符号链接解析。它可以减少词法差异，但无法阻止链接目标在调用之间变化。

比较 EvalSymlinks 的返回值就能防止目录穿越吗？

不能单独依赖字符串比较。要同时处理符号链接、目录边界和检查到使用之间的竞态，并根据平台选择安全的文件打开策略。