http.FileServer 返回404的主因是未用http.StripPrefix剥离URL前缀，导致其用含前缀路径（如/static/style.css）直接查找磁盘文件；正确做法是StripPrefix后传入绝对或有效相对路径的http.Dir。
为什么 http.FileServer 返回 404 而不是你的文件
常见现象是：路径看着对，浏览器访问 /static/style.css 却报 404。根本原因在于 http.FileServer 接收的是「文件系统路径」，但它的行为受 http.StripPrefix 和请求路径前缀的配合影响——它不自动映射 URL 路径到磁盘路径。
实操建议：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 必须用
http.StripPrefix去掉请求中的前缀，否则FileServer会拿完整路径（比如/static/xxx）去磁盘里找，而你的根目录下根本没有static这层嵌套 - 传给
http.FileServer的参数必须是http.Dir类型，且路径需为**绝对路径**或相对于当前工作目录的有效路径；相对路径容易因启动位置不同失效 - Windows 下注意路径分隔符不影响
http.Dir，它内部做了标准化，但手动拼接字符串时仍建议用filepath.Join
示例正确写法：
fs := http.FileServer(http.Dir("./public"))<br>http.Handle("/static/", http.StripPrefix("/static/", fs))这样访问 /static/logo.png 才会去找 ./public/logo.png。
如何让 http.FileServer 支持 SPA 的 fallback 路由
单页应用（如 Vue/React）在刷新时，浏览器会直接请求 /user/profile 这类前端路由，但后端没有对应文件，FileServer 默认返回 404。它本身不提供 fallback 机制，得自己包一层。
立即学习“go语言免费学习笔记（深入）”；
实操建议：
- 不能依赖
http.NotFoundHandler简单兜底，因为FileServer对不存在路径直接写 404 响应并返回，不会继续往下走 - 要自定义
http.Handler，先尝试用FileServer.ServeHTTP，捕获 404 后再返回index.html - 注意：只对非资源路径 fallback（比如排除
.js、.css、.png等后缀），否则图标、脚本也会被重写成 HTML
关键逻辑片段：
func spaHandler(fs http.Handler) http.Handler {<br> return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {<br> // 先按原样服务<br> w.Header().Set("Cache-Control", "no-cache")<br> if _, err := os.Stat("./public" + r.URL.Path); os.IsNotExist(err) {<br> // 是前端路由，且文件不存在 → fallback 到 index.html<br> r.URL.Path = "/index.html"<br> }<br> fs.ServeHTTP(w, r)<br> })<br>}
http.FileServer 在生产环境为什么不推荐直接用
它适合开发或简单内网服务，但上线后容易出问题：没压缩、无缓存控制、不支持 range 请求（视频/大文件拖拽失败）、无法限制并发或带宽、日志粒度粗。
实操建议：
- 静态资源量稍大（>100 个文件）或有并发访问需求时，务必前置 Nginx 或 Caddy——它们原生支持 gzip、ETag、Last-Modified、HTTP/2 和缓存头精细控制
- 若坚持 Go 内置，至少补上中间件：用
gziphandler.GzipHandler包一层，加w.Header().Set("Cache-Control", "public, max-age=3600")控制缓存 - 禁止将
http.Dir指向项目根目录或..路径——FileServer会解析%2e%2e，导致任意文件读取漏洞
如何调试 http.FileServer 找不到文件的问题
最常卡在路径拼错、权限不足、大小写不一致（尤其 macOS/Linux）、或当前工作目录不是你认为的那个目录。
实操建议：
- 打印真实路径：
abs, _ := filepath.Abs("./public"); log.Println("serving from:", abs)，确认是否真指向你想服务的目录 - 用
os.Stat主动检查文件是否存在：if _, err := os.Stat("./public/index.html"); err != nil { log.Fatal(err) } - 临时加个 handler 查看所有请求路径：
log.Printf("req: %s %s", r.Method, r.URL.Path)，确认浏览器发来的路径和你配置的前缀是否匹配 - Linux/macOS 上注意大小写敏感；Windows 不敏感但部署到服务器就挂了——开发时就统一小写命名
路径问题永远比逻辑问题更隐蔽，别猜，打出来看一眼最省时间。
