静态文件路径404主因是http.FileServer根路径与请求路径未对齐，需用http.StripPrefix调整映射；开发期需热重载可结合embed+文件监视；生产应交由Nginx代理/static/并移除Go端路由，embed.FS需手动处理MIME类型及统一绝对路径引用。
静态文件路径不生效，http.FileServer 返回 404
常见原因是 http.FileServer 的根路径没对齐请求路径。它默认把 URL 路径直接映射到文件系统路径，比如访问 /static/logo.png，它会尝试读取 ./static/logo.png —— 但如果你传入的是 http.Dir("assets")，而实际文件在 assets/static/logo.png，就会 404。
解决方法是用 http.StripPrefix 配合调整路径映射：
fs := http.FileServer(http.Dir("./assets"))
http.Handle("/static/", http.StripPrefix("/static/", fs))
这样请求 /static/logo.png 才会真正查找 ./assets/logo.png。注意 StripPrefix 的第二个参数必须带结尾斜杠（"/static/"），否则前缀截取会出错。
开发期自动刷新静态文件，但 http.FileServer 不支持热重载
http.FileServer 是只读、无监听的，改了 CSS/JS 文件后必须手动重启服务。开发时更推荐用第三方包如 github.com/rakyll/statik 或直接启用 Go 的内置文件监视（Go 1.21+）配合 embed + 重新加载 handler。
立即学习“go语言免费学习笔记（深入）”；
更轻量的做法是用 embed + http.FileServer 构建时打包，再加一层包装支持开发期动态读取：
- 开发时用
os.Stat检查文件是否存在，存在则走http.Dir；否则 fallback 到 embed FS - 生产构建时只用 embed，避免依赖外部文件路径
- 别在 handler 里反复调用
os.Open，容易触发文件句柄泄漏
生产部署中静态文件被 Nginx 代理，但 Go 还在处理 /static/
如果前端已用 Nginx 直接服务 /static/，Go 应彻底移除对应路由，否则可能因路径冲突导致缓存失效或 403（Nginx 拒绝转发、Go 又没权限读文件）。
典型错误配置：
http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./assets"))))
上线前务必删掉这行，让 Nginx 完全接管。可通过环境变量控制是否注册该 handler：
- 开发环境：
ENV=dev→ 注册/static/ - 生产环境：
ENV=prod→ 跳过注册，靠反向代理分发
同时确保 Nginx 的 root 指向正确目录，且 location / 块里有 
static/expires 1y 和 add_header Cache-Control "public"。
使用 embed.FS 后 CSS 引用图片路径 404
embed.FS 不会自动解析 HTML/CSS 中的相对路径。比如 style.css 里写了 background: url(logo.png)，浏览器会按当前页面 URL 基础路径发起请求，不是相对于 CSS 文件位置。
根本解法是统一静态资源基址：
- 所有 HTML 中用绝对路径，如
- CSS 内部也用绝对路径：
background: url(/static/logo.png) - 避免
../或相对路径，embed 不做路径重写
如果必须保留相对引用，就得自己实现一个支持 base path 解析的 http.FileSystem 包装器，但多数项目没必要，改路径更可控。
Content-Type 推断逻辑 —— http.FileServer 依赖 mime.TypeByExtension，而 embed.FS 默认不带 MIME 映射，需手动 wrap 或用 http.FileServer 的变体（如 gofr.dev/pkg/gofr/http 提供的增强版）。
