http.Handle行为异常，指定路径无法匹配问题求助

问题场景 #

代码如下：

func main() {
    fileserver := http.FileServer(http.Dir("./static"))
    http.Handle("/fill", fileserver)
    http.Handle("/", fileserver)
    http.HandleFunc("/form", formHandler)
    http.HandleFunc("/hello", helloHandler)

    fmt.Printf("Starting server at port 8080\n")
    if err := http.ListenAndServe(":8080", nil); err != nil {
        log.Fatal(err)
    }
}

需求：访问localhost/或localhost/fill时都加载static/index.html，但/fill访问报404，/正常。

问题原因 #

http.FileServer(http.Dir("./static"))的工作逻辑是将请求URL的路径直接映射到static目录下的文件/目录：

• 访问/时，FileServer会自动查找目录下的index.html（这是FileServer的默认行为）
• 访问/fill时，FileServer会去static目录下找名为fill的文件或子目录，找不到就返回404，不会自动指向index.html

解决方案 #

方法1：使用http.StripPrefix处理路径 #

修改/fill的路由注册，把请求路径中的/fill前缀去掉后再交给FileServer，这样访问/fill就相当于访问static根目录，会自动加载index.html：

func main() {
    fileserver := http.FileServer(http.Dir("./static"))
    // 处理/fill路径：去掉前缀后映射到static目录
    http.Handle("/fill/", http.StripPrefix("/fill/", fileserver))
    http.Handle("/", fileserver)
    http.HandleFunc("/form", formHandler)
    http.HandleFunc("/hello", helloHandler)

    fmt.Printf("Starting server at port 8080\n")
    if err := http.ListenAndServe(":8080", nil); err != nil {
        log.Fatal(err)
    }
}

注意路由路径要写成/fill/（带末尾斜杠），这样/fill和/fill/都会被正确处理（Go的路由会自动重定向/fill到/fill/）。

方法2：单独为/fill写Handler函数 #

如果只需要/fill返回index.html，可以直接写一个HandlerFunc读取文件返回：

func main() {
    fileserver := http.FileServer(http.Dir("./static"))
    http.HandleFunc("/fill", func(w http.ResponseWriter, r *http.Request) {
        // 直接返回static/index.html的内容
        http.ServeFile(w, r, "./static/index.html")
    })
    http.Handle("/", fileserver)
    http.HandleFunc("/form", formHandler)
    http.HandleFunc("/hello", helloHandler)

    fmt.Printf("Starting server at port 8080\n")
    if err := http.ListenAndServe(":8080", nil); err != nil {
        log.Fatal(err)
    }
}

这种方式更直接，适合只需要特定路径返回单一文件的场景。

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