go 中 `http.fileserver` 返回 404 的常见原因是请求路径与文件系统路径未对齐，核心在于 `http.dir` 指定的根目录与 `http.handle` 注册路径不匹配，需配合 `http.stripprefix` 修正 url 路径前缀。
在 Go Web 开发中，http.FileServer 是提供静态文件服务的常用工具，但新手常因路径映射逻辑理解偏差而遭遇“文件明明存在却始终返回 404”的问题。根本原因在于：http.FileServer 接收请求后，会将完整的请求 URL 路径（含注册时的前缀）作为相对路径，拼接到 http.Dir 指定的本地根目录下查找文件。
例如，你注册了：
data := http.FileServer(http.Dir("data"))
http.Handle("/data/", data)当用户访问 /data/static_file.json 时，FileServer 实际尝试打开的文件路径是：
./data/data/static_file.json // ❌ 错误：多了一层 "data/"
而非预期的：
./data/static_file.json // ✅ 正确
这是因为 http.Dir("data") 将本地 data/ 目录设为服务根，而 /data/ 前缀未被剥离，导致路径重复叠加。
✅ 正确解法是使用 http.StripPrefix 移除注册路径前缀，使内部路径匹配本地结构：
func main() {
// 正常服务 html/
html := http.FileServer(http.Dir("html"))
http.Handle("/", html)
// 正确服务 data/ 下的文件（推荐方式）
data := http.FileServer(http.Dir("data"))
http.Handle("/data/", http.StripPrefix("/data/", data))
fmt.Println("Listening on port " + port + "...")
log.Fatal(http.ListenAndServe(port, nil))
}此时，对 /data/static_file.json 的请求会被 StripPrefix 处理为 static_file.json，再由 FileServer 在 ./data/ 目录下准确找到 static_file.json。
⚠️ 注意事项：
- http.StripPrefix 必须放在 http.FileServer 外部，作为中间 handler 包裹它；
- 前缀字符串（如 "/data/"）必须以 / 结尾，否则无法精确匹配子路径；
- 若希望所有 /data/* 请求都指向 data/ 目录，切勿注册为 http.Handle("/data", ...)（缺少结尾 /），否则 /data/foo 可能被错误重定向或匹配失败；
- 调试时可通过打印 http.Dir 的实际值（如 &http.fileHandler{root:"data"}）确认根路径设置。
总结：http.FileServer 的路径解析是「注册路径 + 本地根目录」的组合逻辑，务必用 http.StripPrefix 显式剥离 URL 前缀，才能实现语义清晰、行为可靠的静态文件服务。
