Golang Gin框架：Handler传递Users数据至HTML模板不显示问题

问题背景 #

使用Gin框架开发时，尝试从userHandler.Index方法将Users对象切片传递到user_index.html模板，页面初始无法显示该数据，后续已解决数据显示问题，以下是问题排查过程与相关代码。

相关代码 #

userHandler.go #

func (h *userHandler) Index(c *gin.Context) {
    users, err := h.userService.GetAll()
    if err != nil {
        c.HTML(http.StatusInternalServerError, "error.html", nil)
        return
    }
    c.HTML(http.StatusOK, "user_index.html", gin.H{
        "users":    users,
        "testings": "testing string",
    })
    // 验证数据是否获取成功
    // fmt.Printf("%v", users)
}

user_index.html #

<table class="table table-striped" id="table1">
    <thead>
        <tr>
            <th>{{ .testings }}</th>
            <th>Name</th>
            <th>Email</th>
            <th>Ocuppation</th>
            <th>Status</th>
        </tr>
    </thead>
    <tbody>
        {{ range .users}}
        <tr>
            <td></td>
            <td>{{ .Name }}</td>
            <td>{{ .Email }}</td>
            <td>{{ .Ocuppation }}</td>
            <td>
                <span class="badge bg-success">Active</span>
            </td>
        </tr>
        {{ end }}
    </tbody>
</table>

路由配置 #

router.HTMLRender = loadTemplates("./web/templates")

router.GET("/users", userWebHandler.Index)

排查与解决要点 #

• 验证数据有效性：取消fmt.Printf的注释，确认userService.GetAll()返回的users切片是否包含有效数据，排除数据获取环节的问题。
• 检查结构体字段可见性：确保Users结构体的字段是首字母大写的导出字段（如Name、Email），Gin模板只能访问导出字段，小写开头的字段无法在模板中读取。
• 确认模板加载正确性：检查loadTemplates函数是否正确遍历了模板目录下的所有文件，包括嵌套子目录（如果有的话），确保user_index.html被正确加载。
• 模板语法校验：
  • 确认{{ range .users}}语法正确，循环变量能正确获取切片中的每个元素。
  • 检查字段名拼写是否一致（比如代码中的Ocuppation可能是拼写错误，正确应为Occupation，需与结构体字段名完全匹配）。
• 测试变量验证通道：通过testings变量能正常显示，说明模板与Handler之间的数据传递通道是通的，问题大概率出在users数据本身或字段访问权限上。

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