Go http.NewFileTransportFS 怎么测试静态资源客户端

测试静态资源客户端时，直接读取真实目录往往会把路径、权限和机器环境一起带进来。更稳定的做法是用 fstest.MapFS 准备内存文件，再用 http.NewFileTransportFS 把这个 fs.FS 接到 http.Client 的 file 协议上。这样既能断言正文，也能把缺失文件的 404 纳入同一个测试。

先把真实磁盘问题隔离出去

这个场景的症状通常是：本机能读到静态文件，CI 换了工作目录后却变成 404。根因不是客户端请求逻辑，而是测试把文件系统当成了隐含前置条件。fstest.MapFS 可以用内存数据表达固定文件树，测试不需要创建临时目录，也不会依赖操作系统路径。

Go 1.22 为 net/http 增加了面向 fs.FS 的 NewFileTransportFS。它适合测试“客户端如何读取静态资源”，不是用来启动 HTTP 服务；请求会走 file 协议，URL 的 host 也不会成为文件查找依据。

用 file 协议把 fs.FS 接到 http.Client

关键连接只有两层：先把文件系统交给 NewFileTransportFS，再把返回的传输器注册给 Transport。http.Client 仍然使用常规的 Get 方法，但 URL scheme 改成 file。

package filetransport_test

import (
    "io"
    "net/http"
    "testing"
    "testing/fstest"
)

func newFileClient() *http.Client {
    // MapFS 让测试文件固定在内存中，不依赖当前工作目录。
    fsys := fstest.MapFS{
        "index.html": &fstest.MapFile{Data: []byte("hello from mapfs")},
    }

    transport := &http.Transport{}
    // file scheme 必须显式注册，Client 才知道如何处理 file URL。
    transport.RegisterProtocol("file", http.NewFileTransportFS(fsys))
    return &http.Client{Transport: transport}
}

func TestStaticResourceClient(t *testing.T) {
    client := newFileClient()

    resp, err := client.Get("file:///index.html")
    if err != nil {
        t.Fatalf("读取静态资源失败: %v", err)
    }
    // 响应体由客户端持有，断言前先安排关闭，避免测试泄漏资源。
    defer resp.Body.Close()

    if resp.StatusCode != http.StatusOK {
        t.Fatalf("状态码 = %d，期望 %d", resp.StatusCode, http.StatusOK)
    }
    body, err := io.ReadAll(resp.Body)
    if err != nil {
        t.Fatalf("读取响应体失败: %v", err)
    }
    if string(body) != "hello from mapfs" {
        t.Fatalf("响应体 = %q，内容不符合预期", body)
    }
}

这里的 file:///index.html 对应 MapFS 中的 index.html。不要把它写成操作系统的绝对路径，也不要把 file 注册在 http.DefaultTransport 上后再误以为默认客户端会自动使用它；示例明确绑定了自定义 Transport。

把成功路径和失败路径放进同一个测试

只断言一次 200 还不够。静态资源客户端真正容易漏掉的是“文件不存在时是否得到可判断的响应”。对于缺失文件，通常应检查响应状态并关闭响应体，而不是把 404 当成网络层错误。

func TestStaticResourceCases(t *testing.T) {
    client := newFileClient()
    cases := []struct {
        name       string
        url        string
        wantStatus int
        wantBody   string
    }{
        {name: "existing", url: "file:///index.html", wantStatus: 200, wantBody: "hello from mapfs"},
        {name: "missing", url: "file:///missing.txt", wantStatus: 404},
    }

    for _, tc := range cases {
        t.Run(tc.name, func(t *testing.T) {
            // 每个子测试单独关闭 Body，避免循环中积累未关闭响应。
            resp, err := client.Get(tc.url)
            if err != nil {
                t.Fatalf("请求 %s 失败: %v", tc.url, err)
            }
            defer resp.Body.Close()

            if resp.StatusCode != tc.wantStatus {
                t.Fatalf("状态码 = %d，期望 %d", resp.StatusCode, tc.wantStatus)
            }
            if tc.wantBody != "" {
                body, err := io.ReadAll(resp.Body)
                if err != nil {
                    t.Fatalf("读取 %s 失败: %v", tc.url, err)
                }
                if string(body) != tc.wantBody {
                    t.Fatalf("响应体 = %q，期望 %q", body, tc.wantBody)
                }
            }
        })
    }
}

四个边界决定测试是否可靠

如果测试使用自定义 fs.FS，重点检查打开后的文件是否支持 Seek。官方文档明确要求提供给 NewFileTransportFS 的文件实现 io.Seeker；否则目录列表、内容长度或读取过程中的定位动作可能在测试中暴露问题。

相关问题

为什么不用 httptest.NewServer？

httptest.NewServer 测的是 HTTP 服务端和网络请求；NewFileTransportFS 测的是客户端从文件系统适配层读取资源。两者关注点不同，前者不能替代这里的 file transport 测试。

file URL 的 host 会影响读取目录吗？

不会把 host 当成文件根目录。NewFileTransportFS 的文档说明它会忽略请求 URL 的 host 以及大部分其他请求属性，测试应把注意力放在路径和文件内容上。

缺失文件应该检查 err 还是 StatusCode？

先按示例处理响应，再断言 resp.StatusCode == 404。资源不存在通常表现为响应状态，而不是把普通的 404 当成传输失败。