Go embed嵌入SPA时如何配置根路径正确返回index.html

• 传给http.FileServer的是项目根级别的embed.FS，FS内部的文件结构是spa/index.html，访问根路径时FileServer自然会列出根目录下的所有条目（也就是那个spa文件夹链接），不会自动进入spa目录找index.html。
• 用r.Handle("/", ...)在gorilla/mux中注册的是精确匹配根路径的路由，其他路径（比如点击后访问的/spa）根本不会触发这个静态文件处理逻辑，直接返回404。

• 第一步：将embed文件系统的根路径切换到spa子目录
  用fs.Sub()方法把FS的根从项目根目录收缩到spa目录内部，消除外层目录前缀，避免暴露无关的项目结构：

  //go:embed spa
  var embeddedRoot embed.FS
  
  // 导入io/fs包调用Sub方法
  spaFS, err := fs.Sub(embeddedRoot, "spa")
  if err != nil {
      log.Fatal(err)
  }
  

• 第二步：修正路由匹配规则
  改用PathPrefix("/")注册静态文件服务，匹配所有请求路径，而不是仅精确匹配根路径。此时因为FS根已经切到spa目录内部，访问/时FileServer会自动读取spa目录下的index.html返回，不会再展示目录列表。
• 第三步：补充SPA兼容逻辑
  单页应用通常使用history模式路由，当用户访问前端自定义路由（比如/user/123）时，请求的静态文件不存在，需要自动回退到返回根路径的index.html，避免出现刷新页面404的问题。可以通过简单封装静态文件服务实现：

  spaFileServer := http.FileServer(http.FS(spaFS))
  r.PathPrefix("/").Handler(http.HandlerFunc(func(w http.ResponseWriter, req *http.Request) {
      requestPath := strings.TrimPrefix(req.URL.Path, "/")
      // 检查请求的文件是否存在，不存在则回退到index.html
      if _, err := spaFS.Open(requestPath); err != nil {
          req.URL.Path = "/"
      }
      spaFileServer.ServeHTTP(w, req)
  }))
  

package main

import (
	"embed"
	"io/fs"
	"log"
	"net/http"
	"strings"

	"github.com/gorilla/mux"
)

//go:embed spa
var embeddedRoot embed.FS

func main() {
	spaFS, err := fs.Sub(embeddedRoot, "spa")
	if err != nil {
		log.Fatal(err)
	}

	spaFileServer := http.FileServer(http.FS(spaFS))
	r := mux.NewRouter()

	r.PathPrefix("/").Handler(http.HandlerFunc(func(w http.ResponseWriter, req *http.Request) {
		requestPath := strings.TrimPrefix(req.URL.Path, "/")
		if _, err := spaFS.Open(requestPath); err != nil {
			req.URL.Path = "/"
		}
		spaFileServer.ServeHTTP(w, req)
	}))

	log.Println("starting api server")
	log.Fatal(http.ListenAndServe(":8090", r))
}

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