将SvelteKit嵌入Go二进制文件的静态资源服务异常排查

异常原因拆解 #

1. 显示目录列表：FileServer找不到请求路径对应的文件或默认索引页时，会返回目录结构，这是其默认行为。
2. 根路径空白页（嵌套文件404）：V2版本仅匹配根路径/，页面加载后发起的/_app/xxx等资源请求无对应路由处理，导致资源加载失败，页面空白。
3. 根路径直接404：V1版本路由仅匹配/，且StripPrefix逻辑错误：http.FS(svelteStatic)的根是uibuild目录，StripPrefix("/uibuild")后请求路径变为空，无法定位到uibuild/index.html，同时子路径也未被处理。

完整解决方案 #

核心修正点 #

• 用fs.Sub将嵌入的文件系统根目录定位到uibuild，避免路径层级混乱
• 使用Handle("/*")匹配所有请求路径，确保静态资源和SPA路由都能被处理
• 自定义文件系统处理SPA fallback：当请求的文件不存在时，返回index.html，适配SvelteKit的客户端路由

修正后的Main.go代码 #

package main

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

	chi "github.com/go-chi/chi/v5"
)

//go:embed all:uibuild
var svelteStatic embed.FS

// spaFS 包装文件系统，处理SPA fallback
type spaFS struct {
	fs fs.FS
}

func (s spaFS) Open(name string) (fs.File, error) {
	f, err := s.fs.Open(name)
	if os.IsNotExist(err) {
		// 文件不存在时返回index.html，适配SPA路由
		return s.fs.Open("index.html")
	}
	return f, err
}

func main() {
	// 将嵌入的FS根目录切换到uibuild
	staticFS, err := fs.Sub(svelteStatic, "uibuild")
	if err != nil {
		panic(err)
	}

	r := chi.NewRouter()

	// 用包装后的spaFS处理所有路径请求
	// 使用http.FileServer的ServeHTTP方法，配合Handle("/*")匹配所有路由
	r.Handle("/*", http.FileServer(http.FS(spaFS{fs: staticFS})))

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

关键说明 #

1. embed与fs.Sub：//go:embed all:uibuild确保包含所有以_开头的文件（SvelteKit打包后的_app目录），fs.Sub将文件系统根目录切换到uibuild，这样请求/_app/xxx时，直接对应到uibuild/_app/xxx。
2. SPA fallback处理：自定义spaFS结构体重写Open方法，当请求的文件不存在时返回index.html，保证SvelteKit的客户端路由（如/about这类非真实文件路径）能正常工作。
3. 路由匹配：r.Handle("/*", ...)匹配所有请求路径，确保所有静态资源和SPA路由都能被文件服务器处理，避免出现资源404。

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