go项目上线后http.fileserver返回404的根本原因是路径未对齐：http.dir("static")依赖当前工作目录，而本地开发与systemd生产环境的os.getwd()不同；必须用filepath.abs("./static")转绝对路径或改用os.dirfs("static")（go 1.16+），并确保html引用、路由注册、文件路径三者严格一致。
Go 标准库的 http.FileServer 足够用，但直接写 http.Dir("static") 很大概率上线就 404——根本不是代码错，而是路径没对齐。
为什么 http.FileServer 一上线就 404
常见错误是把相对路径当绝对路径用：http.Dir("static") 的行为依赖当前工作目录（os.Getwd()），而你本地 go run main.go 和生产环境用 systemd 启动时 pwd 往往不同。
- 必须用
filepath.Abs("./static")显式转成绝对路径，再传给http.Dir - 更推荐用
os.DirFS("static")（Go 1.16+）：自动拒绝../路径遍历，且不依赖os.Stat的 cwd 行为 - 如果静态文件放在项目外（如
/var/www/html），确保 Go 进程有读权限；Linux 下 SELinux 或用户组限制常导致静默失败，只返回 404 或 500，不报具体路径错误
怎么配 /static/ 前缀才不炸
/static/ 是路由前缀，不是语法关键字。它要同时满足三件事：HTML 中的引用、HTTP 路由注册、本地文件路径，三者必须严格对齐。
- HTML 中引用必须以
/static/开头，比如<link href="/static/css/app.css">；写成css/app.css或./static/css/app.css都会失效 -
http.Handle("/static/", ...)的第一个参数必须和 HTML 中的前缀完全一致（结尾斜杠不能少） -
http.StripPrefix("/static/", ...)的第一个参数也必须和上面一样，否则剩余路径拼到文件系统时多了一层或少了一层 - 最终
http.Dir或os.DirFS指向的，是 Strip 后请求路径所对应的磁盘根目录，比如请求/static/js/main.js→ Strip 后是js/main.js→ 就得去./static/js/main.js找
SPA fallback 怎么写才不卡死
Vue/React 打包后刷新 /user/123 报 404，是因为 http.FileServer 不知道该返回 index.html。没有开箱即用的中间件，得自己判断文件是否存在。
- 别用
http.ServeFile(w, r, "index.html")直接 fallback——它不检查路径合法性，可能被绕过安全过滤 - 正确做法：先用
fs.Open()尝试打开请求路径对应文件；不存在时，再用http.ServeFile返回index.html（注意路径必须是编译期字面量，不能拼接） - 如果用了
embed.FS，必须用http.FS(embedFS)包一层才能传给http.FileServer；且//go:embed的路径必须是字符串字面量，不能是变量
http.ServeFile 为什么不该用来托管整个静态目录
http.ServeFile 只适用于单文件场景，不支持目录索引、缓存、gzip 及大文件流式传输。
- 它只该用在「明确知道要返回哪个文件」的场景，比如下载接口或调试时临时吐一个 HTML
- 典型误用：
http.HandleFunc("/app.js", func(w http.ResponseWriter, r *http.Request) { http.ServeFile(w, r, "dist/app.js") })——看似能用，但一旦文件不存在就 panic，且无法统一设置缓存头、不支持 gzip、不兼容 HTTP/2 的服务器推送 -
http.ServeFile会尝试打开文件并读取全部内容进内存，大文件（>10MB）易触发 OOM - 它不检查
If-Modified-Since，每次请求都重发整个文件，浪费带宽
最容易被忽略的是路径对齐和权限校验：哪怕代码一字不差，os.DirFS("static") 在 systemd 里启动时若没设 WorkingDirectory=，或 SELinux 状态为 enforcing，照样 404——它不会告诉你缺权限，只会沉默地拒之门外。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
