Go testing.T TempDir排查临时目录权限差异的兼容指南

Go 测试里，t.TempDir() 返回成功并不等于后续所有文件操作都拥有相同权限，也不等于测试结束时一定能立刻删除全部内容。兼容排查要把问题拆成三段：临时根路径是否可用、测试目录内的读写是否可用、清理发生时是否还有句柄或子进程占用资源。

t.TempDir() 负责创建并在测试及其子测试结束后清理目录；遇到权限差异时，先记录实际路径和 GOTMPDIR，再检查文件句柄、子进程与并行测试的退出时序。

先确认 t.TempDir 的权限边界

官方文档规定，t.TempDir() 每次返回唯一目录，测试函数及所有子测试完成后会自动删除；如果目录创建失败，测试会直接失败。这个保证覆盖的是目录生命周期，不是业务代码打开文件、启动进程或访问挂载盘后的所有权限。

因此，日志位置很重要。调用 TempDir 时就失败，通常要查 GOTMPDIR 指向的根目录、CI 运行用户和父目录权限；目录已经拿到，随后 WriteFile 或 Mkdir 失败，则应检查目录属性、ACL、容器挂载和实际用户。测试结束时才出现 RemoveAll、unlink 或 Windows “文件正在使用”提示，重点就转到资源释放顺序。

用最小探针定位实际路径和目录权限

不要只根据“Windows 与 Linux 表现不同”下结论。先把测试真正使用的路径打出来，再分别验证文件写入、子目录创建和元数据读取。GOTMPDIR 影响 testing 创建测试临时目录的位置；os.TempDir() 是操作系统默认临时目录，两者可以相同，也可以不同。

package demo

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

func TestTempDirProbe(t *testing.T) {
    dir := t.TempDir()
    t.Logf("test dir=%s GOTMPDIR=%q os.TempDir=%s", dir, os.Getenv("GOTMPDIR"), os.TempDir())

    // 先验证最基本的写入，错误信息保留实际路径，方便对照 CI 用户和挂载点。
    file := filepath.Join(dir, "probe.txt")
    if err := os.WriteFile(file, []byte("probe"), 0o600); err != nil {
        t.Fatalf("write temp file %s: %v", file, err)
    }

    child := filepath.Join(dir, "nested")
    // 单独创建子目录，区分文件写权限与目录创建权限。
    if err := os.Mkdir(child, 0o700); err != nil {
        t.Fatalf("mkdir temp child %s: %v", child, err)
    }
    info, err := os.Stat(dir)
    if err != nil {
        t.Fatalf("stat temp dir %s: %v", dir, err)
    }
    t.Logf("mode=%s", info.Mode())
}

这段探针不负责修复权限，只负责缩小范围。若 t.TempDir() 成功而 WriteFile 失败，先检查运行用户对该目录的写权限、Windows 只读属性、容器卷映射和安全软件拦截。若只有某个 CI 节点失败，比较的是节点上的 GOTMPDIR、用户身份和挂载配置，而不是给测试加一个固定系统路径。

在自动清理前释放文件句柄和子进程

最常见的跨平台差异出现在收尾阶段：Unix 下删除一个仍然打开的文件往往不会立即报错，Windows 则可能因为句柄仍被占用而让 RemoveAll 失败。测试本身没有“忘记清理”的权利，业务代码仍要明确关闭自己打开的资源。

package demo

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

func TestResourceCleanup(t *testing.T) {
    dir := t.TempDir()
    f, err := os.OpenFile(filepath.Join(dir, "data.txt"), os.O_CREATE|os.O_RDWR, 0o600)
    if err != nil {
        t.Fatal(err)
    }
    // Cleanup 按后注册先执行；这里的关闭逻辑会先于 TempDir 的目录删除运行。
    t.Cleanup(func() {
        if err := f.Close(); err != nil {
            t.Errorf("close temp file: %v", err)
        }
    })

    // 真实测试还应在返回前等待 cmd.Wait、关闭 stdout/stderr 管道和退出后台 goroutine。
    if _, err := f.WriteString("ready"); err != nil {
        t.Fatalf("write test data: %v", err)
    }
}

如果测试启动了外部程序，必须在测试函数返回前完成 cmd.Wait()，并关闭由 StdoutPipe、StderrPipe 创建的管道；如果后台 goroutine 仍持有文件或工作目录，也要通过 channel、WaitGroup 或明确的停止信号等待它退出。把 os.RemoveAll(dir) 写进测试末尾通常只会掩盖真正的资源生命周期问题。

按错误位置选择兼容处理方案

最后保留一个可重复的最小测试：固定记录临时路径和环境变量，避免使用真实业务目录；需要验证 Windows 时，在对应系统或 CI 节点运行同一探针。这样得到的是可比较的权限和生命周期证据，而不是“某个平台偶尔能过”的经验判断。

常见问题

t.TempDir 创建成功后还需要手动 os.RemoveAll 吗？

不需要。它会在测试及子测试结束后自动清理。手动删除会让资源释放顺序更难判断，只有明确创建了 TempDir 之外的临时资源时才单独管理。

为什么 Linux 能过，Windows 的 TempDir 清理却失败？

常见原因是 Windows 不允许删除仍被打开的文件或目录。先关闭文件、管道并等待子进程退出，再判断是否还有安全软件或后台进程介入。

GOTMPDIR 和 os.TempDir 应该统一吗？

不必强行统一。先记录两者的值和实际可访问性；如果 CI 的临时根路径属于不可写挂载点，应在 CI 环境设置合适的 GOTMPDIR，而不是在测试代码里写死系统目录。