当前位置：首页 > 文章列表 > Golang > Go教程 > Golang使用http.FileServer配置静态文件服务

Golang使用http.FileServer配置静态文件服务

2025-09-08 12:45:21 0浏览收藏

本文详细介绍了如何使用 Golang 的 `http.FileServer` 方法配置静态文件服务，并结合 `http.Dir` 指定静态文件目录，以及利用 `http.StripPrefix` 去除 URL 前缀，实现更灵活、安全的访问控制。通过示例代码，清晰地展示了如何在 Go 项目中快速搭建静态资源服务器，并处理常见问题，如目录权限、路径斜杠和安全限制。同时，本文也提醒开发者在生产环境中，建议使用 Nginx 等反向代理服务器处理静态文件，以提升性能和安全性，但在开发阶段，`http.FileServer` 仍是一个便捷的选择。掌握这些技巧，能帮助 Golang 开发者轻松构建静态资源服务。

使用 http.FileServer 可方便提供静态文件服务，通过 http.Dir 指定目录并结合 http.StripPrefix 去除 URL 前缀，实现安全灵活的文件访问，适用于开发环境。

Golang静态文件服务如何配置使用http.FileServer方法

在 Go 语言中，使用内置的 net/http 包可以非常方便地提供静态文件服务。其中 http.FileServer 是一个核心工具，它能将指定目录作为静态文件服务器暴露出去。

基本用法：使用 http.FileServer

要创建一个静态文件服务器，你需要使用 http.FileServer 并传入一个实现了 http.FileSystem 接口的对象，最常见的是 http.Dir，它表示一个本地目录。

示例代码：

package main

import (
    "net/http"
)

func main() {
    // 将当前目录作为静态文件根目录
    fs := http.FileServer(http.Dir("./static/"))

    // 将 /static/ 路由映射到文件服务器
    http.Handle("/static/", fs)

    // 启动 HTTP 服务
    http.ListenAndServe(":8080", nil)
}

说明：

http.Dir("./static/")：表示将项目根目录下的 static 文件夹作为文件服务根目录。
http.Handle("/static/", fs)：将所有以 /static/ 开头的请求交给文件服务器处理。
注意路径映射时，URL 路径中 /static/ 会被去掉，再拼接到底层目录中。例如请求 /static/css/app.css，实际会查找 ./static/css/app.css。

去除 URL 前缀：使用 http.StripPrefix

默认情况下，FileServer 会把整个请求路径传给文件系统。如果你希望去掉 URL 中的前缀（如 /static），需要使用 http.StripPrefix。

正确写法：

http.Handle("/static/", http.StripPrefix("/static/", fs))

这样，当访问 /static/images/logo.png 时，StripPrefix 会把 /static/ 去掉，实际查找的是 images/logo.png（相对于指定目录）。

完整示例：提供多个静态目录

package main

import (
    "net/http"
)

func main() {
    // 提供 static 目录下的资源，访问路径为 /static/
    http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./static/"))))

    // 提供 uploads 目录下的资源，访问路径为 /uploads/
    http.Handle("/uploads/", http.StripPrefix("/uploads/", http.FileServer(http.Dir("./uploads/"))))

    // 可选：提供 index.html 作为根路径
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        if r.URL.Path == "/" {
            http.ServeFile(w, r, "./static/index.html")
            return
        }
        http.NotFound(w, r)
    })

    println("Server is running on http://localhost:8080")
    http.ListenAndServe(":8080", nil)
}