Golang中HTTP服务报错：runtime error: invalid memory address or nil pointer dereference

从错误堆栈来看，这是一个典型的空指针解引用问题。具体发生在 html/template.(*Template).Execute 方法中，因为传入的 *Template 指针为 nil。

根据堆栈跟踪，问题出现在 pkg/render/render.go:12 的 RenderTemplate 函数中。以下是可能的原因和解决方案：

问题分析

错误发生在模板执行时，模板对象为 nil。通常是因为：

1. 模板没有正确初始化
2. 模板解析失败
3. 模板缓存为空

解决方案

1. 检查 render.go 文件

// pkg/render/render.go
package render

import (
    "html/template"
    "net/http"
)

var tc = make(map[string]*template.Template)

func RenderTemplate(w http.ResponseWriter, tmpl string) {
    var t *template.Template
    var err error
    
    // 检查模板是否已缓存
    _, inMap := tc[tmpl]
    if !inMap {
        // 模板未缓存，需要解析
        t, err = template.ParseFiles("./templates/" + tmpl)
        if err != nil {
            http.Error(w, err.Error(), http.StatusInternalServerError)
            return
        }
        tc[tmpl] = t
    } else {
        // 从缓存获取模板
        t = tc[tmpl]
    }
    
    // 执行模板前检查是否为 nil
    if t == nil {
        http.Error(w, "模板未找到", http.StatusInternalServerError)
        return
    }
    
    err = t.Execute(w, nil)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
    }
}

2. 初始化模板缓存

在应用启动时预加载所有模板：

// pkg/render/render.go
package render

import (
    "html/template"
    "io/fs"
    "net/http"
    "path/filepath"
)

var tc map[string]*template.Template

func Init() error {
    tc = make(map[string]*template.Template)
    
    // 加载 templates 目录下的所有 .tmpl 或 .html 文件
    files, err := filepath.Glob("./templates/*.html")
    if err != nil {
        return err
    }
    
    for _, file := range files {
        name := filepath.Base(file)
        t, err := template.ParseFiles(file)
        if err != nil {
            return err
        }
        tc[name] = t
    }
    
    return nil
}

func RenderTemplate(w http.ResponseWriter, tmpl string) {
    t, ok := tc[tmpl]
    if !ok {
        http.Error(w, "模板 "+tmpl+" 未找到", http.StatusInternalServerError)
        return
    }
    
    err := t.Execute(w, nil)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
    }
}

3. 在主函数中初始化

// main.go
package main

import (
    "log"
    "net/http"
    "github.com/YRK/jewellery-store/pkg/render"
)

func main() {
    // 初始化模板缓存
    err := render.Init()
    if err != nil {
        log.Fatal("无法初始化模板:", err)
    }
    
    // 设置路由
    http.HandleFunc("/", handlers.Home)
    
    log.Println("服务器启动在 :8080")
    err = http.ListenAndServe(":8080", nil)
    if err != nil {
        log.Fatal("服务器启动失败:", err)
    }
}

4. 使用 template.Must 确保模板有效

// pkg/render/render.go
package render

import (
    "html/template"
    "net/http"
    "sync"
)

var (
    tc   map[string]*template.Template
    once sync.Once
)

func loadTemplates() {
    tc = make(map[string]*template.Template)
    
    // 使用 template.Must 确保模板解析成功
    tc["home.page.html"] = template.Must(template.ParseFiles(
        "./templates/base.layout.html",
        "./templates/home.page.html",
    ))
    
    tc["about.page.html"] = template.Must(template.ParseFiles(
        "./templates/base.layout.html",
        "./templates/about.page.html",
    ))
}

func RenderTemplate(w http.ResponseWriter, tmpl string) {
    once.Do(loadTemplates)
    
    t, ok := tc[tmpl]
    if !ok {
        http.Error(w, "模板未找到: "+tmpl, http.StatusInternalServerError)
        return
    }
    
    err := t.Execute(w, nil)
    if err != nil {
        http.Error(w, err.Error(), http.StatusInternalServerError)
    }
}

调试建议

在 handlers.go 中添加调试信息：

// pkg/handlers/handlers.go
package handlers

import (
    "log"
    "net/http"
    "github.com/YRK/jewellery-store/pkg/render"
)

func Home(w http.ResponseWriter, r *http.Request) {
    log.Println("处理 Home 请求，模板: home.page.html")
    render.RenderTemplate(w, "home.page.html")
}

关键是要确保在调用 t.Execute() 之前，模板对象 t 不为 nil。检查模板文件路径是否正确，文件是否存在，以及模板解析是否成功。