Go os.Readlink 返回相对目标时怎样计算实际路径

如果 os.Readlink 返回的是 ../data/config.json，这只是符号链接里保存的目标文字，不是相对于程序当前工作目录的路径。正确做法是先取得链接文件所在目录，再把相对目标拼到这个目录上；目标本身是绝对路径时则直接保留。需要最终解析到真实文件时，再交给 filepath.EvalSymlinks。

os.Readlink 返回的到底是什么

符号链接可以理解为一个保存了目标字符串的文件。比如 /srv/app/current 指向 ../releases/v3，调用 os.Readlink 得到的就是 ../releases/v3。它不会自动补上 /srv/app，也不会继续解析目标目录里的下一级符号链接。

因此，排查时应把三个值分开记录：链接自身路径、Readlink 返回的目标文字，以及以链接目录为基准得到的候选路径。把第三个值误当成第二个值，是“路径算出来但访问不到”的常见原因。

相对目标要以链接所在目录为基准

下面的辅助函数只负责把 Readlink 的结果转换为“相对于链接目录的候选路径”。它不声称目标一定存在，也不主动消解多级符号链接，这样调用方仍能决定后续是读取、校验还是继续解析。

package main

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

// linkTargetPath 计算符号链接目标的路径表达，不检查目标是否存在。
func linkTargetPath(linkName string) (string, error) {
    // Readlink 只返回链接保存的文字，失败时保留底层 PathError。
    target, err := os.Readlink(linkName)
    if err != nil {
        return "", fmt.Errorf("read link %q: %w", linkName, err)
    }

    // 绝对目标不应再拼接链接目录；相对目标才以链接目录为基准。
    if filepath.IsAbs(target) {
        return filepath.Clean(target), nil
    }
    base := filepath.Dir(linkName)
    return filepath.Clean(filepath.Join(base, target)), nil
}

func main() {
    path, err := linkTargetPath("/srv/app/current")
    if err != nil {
        // 生产代码可用 errors.Is/As 继续区分 NotExist 和 PathError。
        fmt.Println(err)
        return
    }
    fmt.Println(path)
}

示例中链接是 /srv/app/current、目标文字是 ../releases/v3 时，候选路径会落在 /srv/releases/v3。这正是“从链接所在目录向上一级再进入 releases”的含义。filepath.Clean 只清理路径表达式，不会访问文件系统，也不会证明路径安全。

哪些边界必须单独判断

不要用当前工作目录代替链接目录，也不要把 filepath.Clean 当作安全校验。若路径来自用户输入，还要明确允许的根目录，并在解析后检查是否越出边界；单纯的字符串清理不能替代访问控制。

Readlink 与 EvalSymlinks 的职责边界

如果任务是展示“配置里写了什么目标”，选 Readlink；如果任务是打开文件、判断最终归属或处理多级链接，通常需要先调用 filepath.EvalSymlinks。两者不是谁替代谁，而是观察层和解析层的区别。

还要注意错误发生的阶段：Readlink 失败说明链接自身无法读取；手动拼接没有错误返回，目标是否存在要由后续 os.Stat 或打开操作判断；EvalSymlinks 则可能在解析中途因某一级目标缺失而失败。把这些错误混成“Readlink 结果不稳定”，会让排查方向偏离。

常见问题

相对目标为什么不能直接用 filepath.Join(target)？

因为目标相对的是链接所在目录，而不是当前工作目录。必须先取 filepath.Dir(linkName) 再拼接。

filepath.Clean 会不会解析符号链接？

不会。它只规范字符串中的 .、.. 和重复分隔符，不读取文件系统。

什么时候应直接调用 EvalSymlinks？

当你要得到最终实体路径、处理多级符号链接或根据真实位置做判断时使用；同时为目标不存在、权限不足和循环链接准备错误分支。