在Go语言中实现基于ZIP文件的http.FileSystem：静态文件服务实践

type FileSystem interface {
    Open(name string) (File, error)
}

type File interface {
    io.Closer
    io.Reader
    io.Seeker
    Readdir(count int) ([]os.FileInfo, error)
    Stat() (os.FileInfo, error)
}

package main

import (
    "archive/zip"
    "bytes"
    "io"
    "log"
    "net/http"
    "os"
    "path"
    "strings"
    "time"
)

// ZipFileSystem 实现了 http.FileSystem 接口，用于从 ZIP 档案提供文件。
type ZipFileSystem struct {
    zipReadCloser *zip.ReadCloser // 存储 zip.ReadCloser 以便正确关闭
}

// NewZipFileSystem 创建并返回一个新的 ZipFileSystem 实例。
// 它接收 ZIP 文件的路径作为参数。
func NewZipFileSystem(zipFilePath string) (*ZipFileSystem, error) {
    r, err := zip.OpenReader(zipFilePath)
    if err != nil {
        return nil, err
    }
    return &ZipFileSystem{zipReadCloser: r}, nil
}

// Close 关闭底层的 zip.ReadCloser，释放资源。
func (zfs *ZipFileSystem) Close() error {
    if zfs.zipReadCloser != nil {
        return zfs.zipReadCloser.Close()
    }
    return nil
}

// Open 实现了 http.FileSystem 接口的 Open 方法。
// 它在 ZIP 档案中查找指定名称的文件。
func (zfs *ZipFileSystem) Open(name string) (http.File, error) {
    // 清理路径，防止路径遍历攻击，并移除开头的斜杠
    name = path.Clean(name)
    if strings.HasPrefix(name, "/") {
        name = name[1:]
    }

    // 遍历 ZIP 档案中的所有文件
    for _, f := range zfs.zipReadCloser.File {
        // ZIP 档案中的路径通常使用正斜杠
        if f.Name == name {
            rc, err := f.Open()
            if err != nil {
                return nil, err
            }
            // 对于支持 Seek 的文件，我们可能需要将内容读入缓冲区
            // 这样可以避免 zip.File.Open() 返回的 io.ReadCloser 不支持 Seek 的问题。
            buf := new(bytes.Buffer)
            _, err = io.Copy(buf, rc)
            rc.Close() // 及时关闭原始的 ReadCloser
            if err != nil {
                return nil, err
            }

            return &zipFile{
                Reader:   bytes.NewReader(buf.Bytes()), // 使用 bytes.Reader 支持 Seek
                fileInfo: f.FileInfo(),
                closer:   nil, // bytes.Reader 不需要额外关闭
            }, nil
        }
    }

    // 如果文件未找到，返回 os.ErrNotExist
    return nil, os.ErrNotExist
}

// zipFile 实现了 http.File 接口。
type zipFile struct {
    *bytes.Reader // 封装 bytes.Reader 以支持 Read 和 Seek
    fileInfo      os.FileInfo
    closer        io.Closer // 如果有需要额外关闭的底层资源，可以存储在这里
}

// Readdir 实现了 http.File 接口的 Readdir 方法。
// 对于单个文件，通常返回 nil 和 os.ErrNotExist。
func (zf *zipFile) Readdir(count int) ([]os.FileInfo, error) {
    return nil, os.ErrNotExist // 这是一个文件，不是目录
}

// Stat 实现了 http.File 接口的 Stat 方法。
// 返回文件的 os.FileInfo。
func (zf *zipFile) Stat() (os.FileInfo, error) {
    return zf.fileInfo, nil
}

// Close 实现了 http.File 接口的 Close 方法。
// 如果底层有需要关闭的资源（例如原始的 zip.File.Open() 返回的 ReadCloser），
// 可以在这里进行关闭。由于我们已将内容读入 bytes.Reader，通常不需要额外操作。
func (zf *zipFile) Close() error {
    if zf.closer != nil {
        return zf.closer.Close()
    }
    return nil
}

// main 函数：演示如何使用 ZipFileSystem
func main() {
    // 1. 创建一个虚拟的 ZIP 文件用于演示
    // 在实际应用中，这个 ZIP 文件会预先存在
    zipFileName := "static.zip"
    createDummyZip(zipFileName)
    defer os.Remove(zipFileName) // 演示结束后清理创建的 ZIP 文件

    // 2. 初始化 ZipFileSystem
    zfs, err := NewZipFileSystem(zipFileName)
    if err !=