使用Gorilla Mux静态服务时如何移除HTML后缀？

要实现去掉.html后缀访问静态文件，同时保留根路径自动渲染index.html的功能，你可以通过自定义一个请求路径重写的Handler来实现，具体方案如下：

核心思路 #

在请求到达http.FileServer之前对路径做预处理：

• 根路径/直接映射到/index.html
• 非.html结尾且非目录的路径，尝试添加.html后缀并检查文件是否存在，存在则使用新路径，否则保持原路径避免404

完整实现代码 #

package main

import (
	"net/http"
	"os"
	"path/filepath"

	"github.com/gorilla/mux"
)

// 自定义Handler：处理路径重写，移除.html后缀
func stripHTMLSuffix(staticDir string, next http.Handler) http.Handler {
	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		path := r.URL.Path

		// 处理根路径，映射到index.html
		if path == "/" {
			r.URL.Path = "/index.html"
			next.ServeHTTP(w, r)
			return
		}

		// 如果路径已经以.html结尾，直接传递给下一个Handler
		if filepath.Ext(path) == ".html" {
			next.ServeHTTP(w, r)
			return
		}

		// 尝试拼接.html后缀，检查文件是否存在
		htmlPath := path + ".html"
		fullPath := filepath.Join(staticDir, htmlPath)
		if _, err := os.Stat(fullPath); err == nil {
			// 文件存在，修改请求路径
			r.URL.Path = htmlPath
		}

		// 传递请求给原FileServer
		next.ServeHTTP(w, r)
	})
}

func main() {
	staticDir := "./static"
	router := mux.NewRouter()

	// 创建原始的FileServer
	fileServer := http.FileServer(http.Dir(staticDir))
	// 包装自定义的路径重写Handler
	router.PathPrefix("/").Handler(stripHTMLSuffix(staticDir, fileServer))

	http.ListenAndServe(":8080", router)
}

关键说明 #

• stripHTMLSuffix函数负责路径预处理，接收静态文件目录和原FileServer作为参数，返回包装后的Handler
• 通过os.Stat检查拼接后的.html文件是否存在，避免将不存在的路径错误重写导致404
• 保留了原FileServer的所有功能，比如目录列表（如果开启）和静态文件缓存等特性

配置完成后，你可以：

• 通过http://localhost:8080/ 访问static/index.html
• 通过http://localhost:8080/help 访问static/help.html
• 原有的http://localhost:8080/help.html 也依然可以正常访问

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