Go 的 http.FileServer 不支持 Shell 风格的 $HOME 环境变量展开，必须使用绝对路径；否则文件服务将无法定位资源，返回 404。本文详解正确配置静态文件服务的步骤与常见陷阱。
go 的 `http.fileserver` 不支持 shell 风格的 `$home` 环境变量展开，必须使用绝对路径；否则文件服务将无法定位资源，返回 404。本文详解正确配置静态文件服务的步骤与常见陷阱。
在使用 gorilla/mux 搭建静态文件服务时，一个常见却容易被忽略的问题是：Go 标准库（包括 http.FileServer）不会解析或替换类似 $HOME 的 Shell 环境变量。你代码中这一行：
http.FileServer(http.Dir("$HOME/Documents/TEST/Login"))会被 Go 直接当作字面路径 "$HOME/Documents/TEST/Login" 处理——系统自然找不到该目录，最终所有请求均返回 404 Not Found。
✅ 正确做法是：显式提供绝对路径。例如，在 Linux/macOS 上，若当前用户为 alice，应写为：
http.FileServer(http.Dir("/home/alice/Documents/TEST/Login"))更健壮、跨平台的方案是在运行时动态获取用户主目录，推荐使用 os.UserHomeDir()（Go 1.12+）：
package main
import (
"log"
"net/http"
"os"
"time"
"github.com/gorilla/mux"
)
func main() {
// 动态获取 $HOME 并拼接路径
home, err := os.UserHomeDir()
if err != nil {
log.Fatal("无法获取用户主目录:", err)
}
dirPath := home + "/Documents/TEST/Login"
r := mux.NewRouter()
r.PathPrefix("/Login/").Handler(
http.StripPrefix("/Login/", http.FileServer(http.Dir(dirPath))),
)
srv := &http.Server{
Handler: r,
Addr: ":9999", // 请替换为实际地址，如 "127.0.0.1:9999"
WriteTimeout: 600 * time.Second,
ReadTimeout: 600 * time.Second,
}
log.Println("服务启动于 http://localhost:9999/Login/")
log.Fatal(srv.ListenAndServe())
}⚠️ 注意事项：
-
http.Dir()要求路径必须存在且具有可读权限，否则FileServer初始化即 panic； -
http.StripPrefix("/Login/", ...)会移除匹配路径前缀，因此确保前端请求 URL（如/Login/index.html）与磁盘中文件结构（如index.html位于Login/目录下）一致； - Windows 用户需注意路径分隔符（
filepath.Join(home, "Documents", "TEST", "Login")更安全）； - 建议添加简单健康检查路由（如
r.HandleFunc("/health", func(w http.ResponseWriter, _ *http.Request) { w.Write([]byte("OK")) })），便于调试路由是否生效。
总结：永远避免在 http.Dir() 中硬编码 $HOME 或其他环境变量字符串；优先使用 os.UserHomeDir() + filepath.Join() 构建可移植路径，既安全又符合 Go 最佳实践。
