Go os.Root Lstat 怎样查看符号链接自身属性

在用户上传目录、插件工作区或解压目录里判断一个路径是不是符号链接时，直接对全局路径调用 os.Lstat 容易把“路径访问范围”和“文件类型判断”混在一起。Go 1.24 提供的 os.Root 可以先固定目录边界，再用 root.Lstat(name) 查看 Root 内的目录项自身。

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

要判断链接自身，使用 Root.Lstat；它返回描述命名目录项的 FileInfo，遇到符号链接时保留链接本身的类型。需要描述链接目标时，再对照 Root.Stat 的语义。

先把 Root.Lstat 的边界命名清楚

os.OpenRoot 返回一个 *os.Root，它把后续文件操作的入口固定在指定目录。调用 root.Lstat("assets/current") 时，assets/current 是 Root 内的名称，不是让调用方重新拼接任意绝对路径。

这里有两个需要同时保护的对象：一是“允许查看哪棵目录树”，二是“要描述哪个目录项”。Root 负责前者，Lstat 负责后者。把两层语义分开后，符号链接是否存在、它自身是不是链接、链接目标是否可用，就能分别处理。

用 Root.Lstat 读取目录项自身属性

查询流程很短：打开 Root，调用 Lstat，再检查 FileInfo.Mode()。如果返回的模式包含 os.ModeSymlink，说明命名目录项本身是符号链接，而不是普通文件或目录。

package main

import (
	"errors"
	"fmt"
	"os"
)

func inspectLink(root *os.Root, name string) error {
	// Lstat 只描述 name 这个目录项，不主动跟随符号链接。
	info, err := root.Lstat(name)
	if err != nil {
		var pathErr *os.PathError
		if errors.As(err, &pathErr) {
			return fmt.Errorf("检查 %q 失败: %w", name, pathErr)
		}
		return fmt.Errorf("检查 %q 失败: %w", name, err)
	}

	// ModeSymlink 说明返回的 FileInfo 对应的是链接自身。
	if info.Mode()&os.ModeSymlink != 0 {
		fmt.Printf("%s 是符号链接，模式=%s\n", name, info.Mode())
		return nil
	}

	fmt.Printf("%s 不是符号链接，模式=%s\n", name, info.Mode())
	return nil
}

func main() {
	root, err := os.OpenRoot("./workspace")
	if err != nil {
		panic(err)
	}
	defer root.Close() // Root 持有目录资源，使用结束后及时关闭。

	if err := inspectLink(root, "assets/current"); err != nil {
		panic(err)
	}
}

示例中的 assets/current 只是 Root 内的相对名称。代码没有把返回结果伪装成运行截图；它表达的是 API 关系：Root.Lstat 返回 FileInfo，再由调用方依据 ModeSymlink 做类型判断。

把 Root.Lstat 和 Root.Stat 放在一起比较

最容易混淆的是 Lstat 和 Stat 都返回 FileInfo。区别不在返回类型，而在描述对象：Lstat 描述命名的符号链接自身，Stat 采用 os.Stat 的跟随语义，适合描述链接目标。

func compareLinkAndTarget(root *os.Root, name string) error {
	// Lstat 能在链接目标暂时不存在时仍描述链接目录项本身。
	linkInfo, err := root.Lstat(name)
	if err != nil {
		return fmt.Errorf("读取链接自身: %w", err)
	}

	// Stat 关注 name 最终指向的目标；目标不可用时这里可能返回错误。
	targetInfo, err := root.Stat(name)
	if err != nil {
		var pathErr *os.PathError
		if errors.As(err, &pathErr) {
			return fmt.Errorf("读取链接目标: %w", pathErr)
		}
		return fmt.Errorf("读取链接目标: %w", err)
	}

	fmt.Printf("链接自身: %s\n", linkInfo.Mode())
	fmt.Printf("链接目标: %s\n", targetInfo.Mode())
	return nil
}

当 name 是符号链接时，通常可以看到 linkInfo.Mode() 带有 os.ModeSymlink，而 targetInfo.Mode() 体现的是目标文件或目标目录的模式。若业务只想判断“这个入口是不是链接”，不要用 Stat 代替 Lstat。

把错误和路径边界一起处理

Root.Lstat 的名称仍受 Root 边界约束。名称不存在、尝试越过根目录、Root 已经关闭，都会让调用返回错误；这些情况应进入业务自己的错误分支，而不是把“不是符号链接”当成统一结论。

安全场景下还要注意：Lstat 只告诉你目录项的类型，不会自动证明链接目标符合业务权限或租户范围。后续如果要读取目标内容，应把“是否允许跟随”和“目标是否仍在允许范围”作为独立策略。

常见问题

Root.Lstat 和 os.Lstat 有什么区别？

两者都描述符号链接自身，但 Root.Lstat 的名称在 os.Root 管理的目录树内解释，更适合把访问范围和类型判断放在同一个对象上。

为什么 Lstat 成功而 Stat 失败？

常见原因是命名项本身是存在的符号链接，但它指向的目标已经不存在、不可访问或不满足 Root 的路径边界。Lstat 和 Stat 关注的对象不同，所以结果可以不同。

只要不是 ModeSymlink 就能安全读取吗？

不能。ModeSymlink 只是文件类型信息，不能替代权限检查、业务目录授权和目标内容校验。它适合做路径分类，不是完整的安全决策。

总结

要在受限目录里查看符号链接自身属性，先用 os.OpenRoot 建立 Root，再调用 root.Lstat(name) 并检查 FileInfo.Mode()&os.ModeSymlink。需要描述链接目标时才使用 root.Stat(name)，同时把 PathError、Root 生命周期和目标授权作为独立边界处理。