将embed.FS传入http.FileServer后仅返回404错误，求排查方向

你的404错误来自两个关键配置疏漏：

1. 静态文件路径映射不匹配 #

你用fs.Sub(hs.staticFiles, ".")获取的文件系统根目录下直接是css文件夹，但路由前缀设为/static/。当访问/static/css/bulma.css时，http.FileServer会尝试查找static/css/bulma.css，而你的embed文件系统里根本没有static目录，自然返回404。

2. Gorilla Mux未剥离路由前缀 #

Gorilla Mux的PathPrefix不会自动移除匹配的前缀部分，必须显式用http.StripPrefix把/static/去掉，才能让文件服务器正确匹配embed里的文件路径。

修改后的代码示例 #

方案一：直接映射css目录（推荐）

修改pkg/svc/httpd.go中的文件系统处理逻辑：

func (hs httpdService) RunServer() {
    r := mux.NewRouter()

    // 直接从embed.FS中提取css子目录作为文件系统根
    fSys, err := fs.Sub(hs.staticFiles, "css")
    if err != nil {
        log.Fatal("error in static file server: ", err)
    }
    // 剥离/static/css/前缀后，文件服务器直接处理css下的文件路径
    staticServer := http.FileServer(http.FS(fSys))
    r.PathPrefix("/static/css/").Handler(http.StripPrefix("/static/css/", staticServer))

    // 临时输出验证
    println("content of static.StaticFiles (css subdir):")
    fs.WalkDir(fSys, ".", func(path string, d fs.DirEntry, err error) error {
        if err != nil {
            return err
        }
        println(path, "// IsDir:", d.IsDir())
        return nil
    })

    log.Fatal(http.ListenAndServe(":12345", r))
}

方案二：保留根目录调整路由处理

如果需要保留embed的完整根目录（包含css文件夹），则修改路由部分：

func (hs httpdService) RunServer() {
    r := mux.NewRouter()

    fSys, err := fs.Sub(hs.staticFiles, ".")
    if err != nil {
        log.Fatal("error in static file server: ", err)
    }
    staticServer := http.FileServer(http.FS(fSys))
    // 剥离/static/前缀，让文件服务器查找css/bulma.css而非static/css/bulma.css
    r.PathPrefix("/static/").Handler(http.StripPrefix("/static/", staticServer))

    // 临时输出验证
    println("content of static.StaticFiles:")
    fs.WalkDir(fSys, ".", func(path string, d fs.DirEntry, err error) error {
        if err != nil {
            return err
        }
        println(path, "// IsDir:", d.IsDir())
        return nil
    })

    log.Fatal(http.ListenAndServe(":12345", r))
}

验证效果 #

修改完成后，访问http://localhost:12345/static/css/bulma.css即可正确返回对应的CSS文件。

内容的提问来源于stack exchange，提问作者Windowlicker