Go 的 http.FileServer 不支持 shell 环境变量（如 $HOME），必须使用绝对路径；否则文件服务无法定位资源，返回 404。本文详解正确配置静态文件服务的方法及常见陷阱。
go 的 `http.fileserver` 不支持 shell 环境变量（如 `$home`），必须使用绝对路径；否则文件服务无法定位资源，返回 404。本文详解正确配置静态文件服务的方法及常见陷阱。
在使用 gorilla/mux 构建静态文件服务时，一个高频错误是直接在 http.Dir() 中写入带 $HOME 的路径（例如 "$HOME/Documents/TEST/Login"）。Go 标准库不会解析或替换环境变量——该字符串会被原样当作目录名处理，最终导致 http.FileServer 在根目录下查找名为 $HOME 的子目录，自然返回 404。
✅ 正确做法是：显式提供绝对路径。例如，若你的登录页 HTML 文件位于 /home/yourname/Documents/TEST/Login/index.html，则应这样配置：
r.PathPrefix("/Login/").Handler(
http.StripPrefix("/Login/",
http.FileServer(http.Dir("/home/yourname/Documents/TEST/Login"))),
)⚠️ 注意事项：
- 替换
yourname为实际用户名（可通过os.Getenv("HOME")动态获取，见下文）； - 路径末尾不加斜杠
/——http.Dir期望的是目录路径，而非 URL 路径； - 确保 Go 进程对目标目录有读取权限（尤其当用
sudo启动时需格外注意）； - 若
Login目录下无index.html，访问/Login/会返回 404（除非启用http.ServeContent自定义逻辑）。
? 进阶建议：避免硬编码路径，可动态解析 $HOME：
import (
"os"
// ... 其他导入
)
func main() {
homeDir := os.Getenv("HOME")
loginDir := homeDir + "/Documents/TEST/Login"
r := mux.NewRouter()
r.PathPrefix("/Login/").Handler(
http.StripPrefix("/Login/",
http.FileServer(http.Dir(loginDir))),
)
// ... 其余服务器配置
}? 补充验证技巧：启动前添加日志确认路径是否正确：
log.Printf("Serving Login files from: %s", loginDir)总结：Go 的 http.Dir 是纯字面量路径处理器，一切“魔法”（如变量展开、波浪线 ~ 解析）都需开发者显式实现。坚持使用 os.Getenv("HOME") 或 user.HomeDir（需 os/user 包）获取真实路径，即可彻底规避此类 404 问题。
