Go语言http.FileServer挂载根路径/时CSS等静态文件无法加载问题

问题根因 #

你遇到的问题主要是两个常见错误导致的：

• Go语言标准库net/http的路由注册函数是大写开头的http.Handle，你写的小写http.handle是未导出方法，无法正常编译运行
• 路径匹配逻辑与静态资源目录结构不匹配，若项目同时存在API接口路由，还会存在路由优先级的问题

http.FileServer的工作逻辑是将请求的URL路径拼接在你指定的http.Dir目录路径后，查找对应文件。当挂载到根路径/时，不需要加http.StripPrefix，因为请求路径本身就是需要查找的文件相对路径。

正确配置方案 #

场景1：项目只有静态资源，无其他接口路由 #

直接使用如下代码即可：

package main

import (
    "net/http"
)

func main() {
    // 定义静态资源目录为当前目录下的html文件夹
    fs := http.FileServer(http.Dir("./html"))
    // 注册根路径路由，注意Handle首字母大写
    http.Handle("/", fs)

    // 启动服务，监听8080端口
    _ = http.ListenAndServe(":8080", nil)
}

需要保证你的静态资源目录结构如下：

你的项目目录
├── html
│   ├── index.html
│   └── css
│       └── style.css
└── 你的Go源码文件/main.go

在html文件中引用CSS的路径要写根路径绝对路径：

<link rel="stylesheet" href="/css/style.css">

场景2：项目同时存在API接口路由 #

Go的默认ServeMux遵循最长路径匹配规则，只需要先注册API路由，再注册根路径的静态资源路由即可，API请求会优先匹配到对应接口，剩余请求走静态资源：

package main

import (
    "net/http"
)

func main() {
    // 先注册所有API路由
    http.HandleFunc("/api/user", func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("user api"))
    })

    // 最后注册静态资源路由
    fs := http.FileServer(http.Dir("./html"))
    http.Handle("/", fs)

    _ = http.ListenAndServe(":8080", nil)
}

常见踩坑说明 #

• 工作目录问题：./html是相对于程序运行时的工作目录，不是Go源码文件的目录，部署启动二进制文件时要保证工作目录下存在html文件夹，或者直接使用绝对路径指定静态资源目录
• 大小写问题：Linux/macOS环境下文件路径区分大小写，要保证HTML中引用的资源路径和实际文件路径大小写完全一致
• 缓存问题：修改静态资源后如果不生效，可以强制刷新浏览器清除缓存验证

内容的提问来源于stack exchange，提问作者lmidori