Go template不渲染问题：向Handler传递参数后模板无法正常渲染

问题排查与修复方案 #

核心错误原因 #

• 路由注册不一致导致Handler未触发：你同时混用了gorilla/mux自定义路由器和Go标准库默认的全局路由器，indexHandler注册在你创建的mux.Router实例上，后两个Handler是通过http.HandleFunc注册到标准库默认路由器的。如果启动服务时你传入的是自定义的router作为服务handler，默认路由器上的规则完全不会生效，后两个Handler根本不会执行，自然没有日志输出也不会渲染模板。
• 同路径重复注册被覆盖：就算把所有Handler注册到同一个路由器，同一路径/重复注册多个Handler，只会匹配第一个注册的规则，后面的会被直接忽略。
• 依赖导入缺失：代码中使用了mux.NewRouter()，但import块没有导入github.com/gorilla/mux依赖，编译无法通过。
• 额外注意：你声明的全局tmpl变量没有做初始化赋值，直接执行模板渲染会触发空指针panic

修复代码示例 #

package main

import (
    "fmt"
    "html/template"
    "net/http"
    "github.com/gorilla/mux" // 补充缺失的mux依赖
    "local-pkg/pages"
    "local-pkg/structs"
)

var tmpl *template.Template
var htmlTags map[string]structs.Tags

func main() {
    // 先初始化模板，替换为你实际的模板文件路径
    var err error
    tmpl, err = template.ParseGlob("templates/*.html")
    if err != nil {
        panic(err)
    }

    router := mux.NewRouter()
    // 不同Handler分配不同路径，全部注册到同一个mux实例
    router.HandleFunc("/", indexHandler).Methods("GET")
    router.HandleFunc("/test", testHandler(pages.GetHTMLTags())).Methods("GET")
    router.HandleFunc("/page2", func(w http.ResponseWriter, r *http.Request) {
        page2Handler(w, r, pages.GetHTMLTags())
    }).Methods("GET")

    // 启动服务传入自定义router
    http.ListenAndServe(":8080", router)
}

func indexHandler(w http.ResponseWriter, req *http.Request) {
    fmt.Println(fmt.Printf("%T", tmpl))
    data := pages.GetHTMLTags()
    err := tmpl.ExecuteTemplate(w, "index", data["index"])
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
    }
}

func testHandler(page map[string]structs.Tags) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        fmt.Println(fmt.Printf("%T", tmpl))
        err := tmpl.ExecuteTemplate(w, "index", page["index"])
        if err != nil {
            http.Error(w, err.Error(), http.StatusInternalServerError)
        }
    }
}

func page2Handler(w http.ResponseWriter, r *http.Request, data map[string]structs.Tags) {
    fmt.Println(fmt.Printf("%T", tmpl))
    err := tmpl.ExecuteTemplate(w, "index", data["index"])
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
    }
}

修复后访问http://localhost:8080/test即可触发testHandler，访问http://localhost:8080/page2即可触发page2Handler。

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