http.fileserver 默认404因路径映射机制严格：/映射空文件、/assets需尾斜杠才查目录、相对路径受工作目录影响；须用os.dirfs+stripprefix+自定义fallback（如spa路由）并加缓存、gzip、安全校验三层包装。
为什么直接用 http.FileServer 会 404
不是代码写错了，是它根本没被设计成“开箱即用”的 Web 服务器。它只做一件事：把 URL 路径原样拼到文件系统路径上，然后调 os.Open。所以：
- 访问
/→ 查根目录下空字符串文件 → 404 - 访问
/assets（不带尾斜杠）→ 查文件assets，不是目录 → 404；只有/assets/才会触发index.html查找 - 传
http.Dir("./public")→ 工作目录一变，路径就错，静默 404
解决方法不是换库，而是补一层路由判断：先检查是否该返回 index.html，再交给 http.FileServer 处理其他请求。
必须用 os.DirFS + http.StripPrefix 构造安全路径
os.DirFS（Go 1.16+）比老式 http.Dir 更安全：默认拒绝含 .. 的路径（如 %2e%2e%2fetc%2fpasswd），也不受工作目录影响。
-
http.StripPrefix的前缀必须以/结尾，且顺序不能反："/static/"✅，"/static"❌（会错误匹配/static123） - 必须先
StripPrefix，再交给FileServer；反过来调用ServeHTTP会绕过内置路径校验 - 绝对路径构造推荐：
dir, _ := filepath.Abs("./public")，别信相对路径
示例写法：
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
fs := http.FileServer(http.FS(os.DirFS(dir)))
http.Handle("/static/", http.StripPrefix("/static/", fs))
SPA 应用刷新路由时为啥还是 404
http.FileServer 完全不懂前端路由。它看到 /user/123，就去文件系统找这个路径，找不到就 404 —— 不会 fallback 到 index.html。
- 正确做法：自定义
http.Handler，先用os.Stat检查文件是否存在 - 仅当路径无扩展名（如
/admin、/）且文件不存在时，才返回index.html - 用
http.ServeFile返回index.html，它会自动校验路径、拒绝目录遍历 - 别用重定向或硬编码响应体替代 —— 前者暴露真实路径结构，后者不支持相对引用
生产环境必须加的三层包装
原生 http.FileServer 是裸 handler，要变成“高性能”，得自己套三层：
-
缓存头：对
.js、.css、.woff2设Cache-Control: public, max-age=31536000, immutable；对index.html必须设no-cache或must-revalidate -
gzip 压缩：文本类资源未压缩体积常翻倍，需中间件手动启用
gzip编码 -
fallback + 安全兜底：比如加快速过滤
if strings.Contains(r.URL.Path, "..") { http.Error(w, "Forbidden", http.StatusForbidden); return }
大文件（>10MB）别走内存缓存，只靠 Cache-Control 和 Range 支持；ETag 必须动态算，不能硬编码哈希 —— 文件被 logrotate 修改后，Go 进程不会自动感知，写操作完成后必须显式清理缓存。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
