如何修复 Go 语言中 Mux 路由不生效导致的 404 错误

本文详解 Go 使用 gorilla/mux 时因 http.ListenAndServeTLS 参数遗漏路由器实例而导致路由注册失效的问题，并提供完整可运行的 HTTPS 服务配置方案。

本文详解 go 使用 gorilla/mux 时因 `http.listenandservetls` 参数遗漏路由器实例而导致路由注册失效的问题，并提供完整可运行的 https 服务配置方案。

在使用 gorilla/mux 构建多域名、多路由的 Go Web 服务时，一个常见但极易被忽略的错误是：*未将配置好的路由器（`mux.Router）作为http.ListenAndServeTLS的第三个参数传入**。这会导致 TLS 服务器实际接收到请求后无路由可匹配，最终统一返回404 Not Found—— 即使你的HandleFunc` 已正确注册、文件服务器路径也配置无误。

你提供的代码中存在关键问题：

http.ListenAndServeTLS(":443", "domain-crt.pem", "domain-key.pem", nil) // ❌ 错误：handler 为 nil

此处传入了 nil，意味着 TLS 服务器使用的是 http.DefaultServeMux，而你所有基于 mux.NewRouter() 的路由（如 s.HandleFunc("/", indexEchec)）都注册在自定义的 r 上，与默认复用器完全无关，因此永远无法命中。

✅ 正确做法是将构建完成的路由器 r 显式传入：

Skill Weave Chains — 技能链路由引擎

开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。

下载

// ✅ 修正后的 main 函数（关键修改已加注）
func main() {
    // HTTP → HTTPS 重定向（监听 :80）
    go http.ListenAndServe(":80", http.HandlerFunc(redirect))

    // HTTPS 主服务（监听 :443）
    r := mux.NewRouter()

    // 静态资源路由：/static/ → /root/go/src/web/static/
    r.PathPrefix("/static/").Handler(
        http.StripPrefix("/static/", http.FileServer(http.Dir("/root/go/src/web/static/"))),
    )

    // 基于 Host 的子路由：仅匹配 echecderi.me
    s := r.Host("echecderi.me").Subrouter()
    s.HandleFunc("/", indexEchec).Methods("GET")

    // ⚠️ 关键修复：必须传入 r 作为 handler，而非 nil
    log.Fatal(http.ListenAndServeTLS(":443", "domain-crt.pem", "domain-key.pem", r))
}

此外，还需注意以下几点以确保稳定性与安全性：

添加 HTTP 方法限制：建议显式指定 Methods("GET")，避免意外接受其他动词（如 POST）触发 405。
日志与错误处理：使用 log.Fatal 包裹 ListenAndServeTLS，便于捕获启动失败（如证书路径错误、端口被占等）。
证书路径权限：确保 domain-crt.pem 和 domain-key.pem 对运行 Go 进程的用户可读（尤其当以非 root 用户运行时，避免因权限问题静默失败）。
Host 匹配区分大小写？：r.Host("echecderi.me") 默认区分大小写；若需兼容 EchecDeri.me，应使用正则匹配：r.Host("{host:echecderi\.me}").Subrouter() 或统一转换 Host 头为小写（通过中间件预处理 req.Host）。