如何解决 gorilla/mux 中因路径未展开导致的 404 错误-Golang-PHP中文网

如何解决 gorilla/mux 中因路径未展开导致的 404 错误

Go 的 http.FileServer 不支持 shell 环境变量（如 $HOME），需使用绝对路径；否则 http.Dir() 会查找字面值目录，导致路由匹配失败并返回 404。

go 的 `http.fileserver` 不支持 shell 环境变量（如 `$home`），需使用绝对路径；否则 `http.dir()` 会查找字面值目录，导致路由匹配失败并返回 404。

在使用 gorilla/mux 构建静态文件服务时，一个常见却隐蔽的错误是：在 http.Dir() 中直接写入含 $HOME 的字符串路径（例如 "$HOME/Documents/TEST/Login"）。Go 的标准库 不会解析或替换任何 shell 环境变量——它会将 $HOME 当作真实目录名去查找，自然无法定位到用户主目录，最终所有请求均触发 404。

✅ 正确做法是：显式提供绝对路径，或通过 Go 原生方式安全获取用户主目录：

✅ 推荐方案：使用 `os.UserHomeDir()`

package main

import (
    "log"
    "net/http"
    "os"
    "time"

    "github.com/gorilla/mux"
)

func main() {
    // 安全获取当前用户主目录
    home, err := os.UserHomeDir()
    if err != nil {
        log.Fatal("无法获取主目录:", err)
    }

    // 拼接完整绝对路径（注意末尾不加斜杠，http.Dir 要求目录存在且可读）
    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", // 示例中已移除 {address} 占位符，请替换为实际 IP 或保留 ":9999" 绑定 localhost
        WriteTimeout: 600 * time.Second,
        ReadTimeout:  600 * time.Second,
    }

    log.Println("服务器启动于 http://localhost:9999/Login/")
    log.Fatal(srv.ListenAndServe())
}

⚠️ 注意事项：

http.Dir() 的路径参数必须指向真实存在的、具有读取权限的目录；若路径错误或权限不足，FileServer 会静默返回 404（而非 panic）。
PathPrefix("/Login/") + StripPrefix("/Login/", ...) 是标准组合：确保访问 /Login/index.html 时，FileServer 实际查找的是 index.html（而非 /Login/index.html）。
路径拼接避免硬编码 /home/username —— 它不具备跨用户/跨系统可移植性；os.UserHomeDir() 是平台无关的安全选择（支持 Linux/macOS/Windows）。
若服务需部署在容器或无主目录环境（如某些 CI 用户），建议通过配置文件或环境变量传入路径，并做存在性校验：
```
if _, err := os.Stat(dirPath); os.IsNotExist(err) {
    log.Fatal("静态资源目录不存在:", dirPath)
}
```