本文讲解如何将 sqlx 查询的多行结果正确传递并渲染到 go html 模板中，重点解决 `sql.rows` 无法直接在模板中 range 迭代的问题，并提供结构清晰、类型安全、可维护的解决方案。
在 Go Web 开发中，直接将 *sql.Rows（或 sqlx.Rows）传入 HTML 模板并尝试用 {{range .NumOfRows}} 迭代是不可行的——因为 sql.Rows 不是切片、map、channel 或可 range 的接口类型，Go 模板引擎会报错：“cannot range over … (type *sql.Rows)”。原问题中尝试用 "NewRow" 字符串打标的方式属于临时规避，不仅破坏数据结构语义，还极易出错（如字段值恰好为 "NewRow" 时逻辑崩溃），不推荐生产使用。
✅ 正确做法是：在 Go 后端完成数据提取与结构化，将查询结果转换为强类型的切片（如 []map[string]interface{} 或自定义结构体切片），再传入模板。这样既符合 Go 的类型安全哲学，也使模板简洁、可读、可测试。
✅ 推荐实现方案（结构化 + 类型安全）
首先，定义清晰的数据结构。避免使用固定长度数组（如 [9]string），改用动态切片：
type RowData map[string]interface{} // 列名 → 值（支持 nil, string, int, []byte 等）
type WebData struct {
Title string
Heading string
GridTitle string
ColumnNames []string // 动态列名
Rows []RowData // 每行是 map，键为列名，值为对应数据
}接着，在 ConsoleHandler 中重构数据提取逻辑（关键改进点已注释）：
立即学习“前端免费学习笔记（深入）”；
func ConsoleHandler(w http.ResponseWriter, r *http.Request) {
var wdata WebData
wdata.Title = "Page Title"
wdata.Heading = "My View"
wdata.GridTitle = "My Grid Title"
lodbc.SetODBCVersion(lodbc.ODBCVersion_3)
db, err := sqlx.Open("lodbc", "[connectionstring]")
if err != nil {
http.Error(w, "DB connection failed: "+err.Error(), http.StatusInternalServerError)
return
}
defer db.Close() // ✅ 正确位置：handler 结束前关闭
rows, err := db.Queryx("[SELECT ...]") // 使用 sqlx.Queryx 支持 Columns()
if err != nil {
http.Error(w, "Query failed: "+err.Error(), http.StatusInternalServerError)
return
}
defer rows.Close() // ✅ 必须显式关闭 rows
// 获取列名（动态）
columns, err := rows.Columns()
if err != nil {
http.Error(w, "Failed to get columns: "+err.Error(), http.StatusInternalServerError)
return
}
wdata.ColumnNames = columns
// 逐行扫描，构建 []RowData
for rows.Next() {
// 创建与列数等长的 interface{} 切片
values := make([]interface{}, len(columns))
scanArgs := make([]interface{}, len(values))
for i := range values {
scanArgs[i] = &values[i]
}
if err := rows.Scan(scanArgs...); err != nil {
http.Error(w, "Scan error: "+err.Error(), http.StatusInternalServerError)
return
}
// 构建单行 map：列名 → 格式化值
row := make(RowData)
for i, col := range columns {
val := values[i]
switch v := val.(type) {
case nil:
row[col] = ""
case []byte:
row[col] = string(v)
default:
row[col] = v
}
}
wdata.Rows = append(wdata.Rows, row)
}
if err := rows.Err(); err != nil { // 检查 Next() 循环后的错误
http.Error(w, "Rows iteration error: "+err.Error(), http.StatusInternalServerError)
return
}
t, err := template.ParseFiles("template.html")
if err != nil {
http.Error(w, "Template parse error: "+err.Error(), http.StatusInternalServerError)
return
}
if err := t.Execute(w, wdata); err != nil {
http.Error(w, "Template execution error: "+err.Error(), http.StatusInternalServerError)
return
}
}? 对应 HTML 模板（template.html）
{{.Title}} {{.Heading}}
{{range .ColumnNames}} {{range .Rows}}{{.}} {{end}}{{range $colName, $val := .}} {{end}}{{. | printf "%v"}} {{end}}
? 提示：{{. | printf "%v"}} 是安全输出任意类型的通用方式；若需更精细控制（如日期格式化、空值显示 -），可在 Go 层预处理或定义自定义模板函数。
⚠️ 关键注意事项
- 永远 defer rows.Close()：避免连接泄漏；
- 不要忽略 rows.Err()：rows.Next() 返回 false 后仍需检查潜在扫描错误；
- 避免全局 db 变量：应通过依赖注入或配置函数管理数据库实例，提升可测试性；
- 错误处理必须返回 HTTP 错误响应：而非 panic 或仅 fmt.Println，否则客户端收到空响应；
- SQLX 更佳实践：优先使用 db.Select(&dest, query, args...) 配合结构体，比手动 Scan 更简洁（尤其当列名固定时）。
✅ 总结
将数据库结果渲染到 HTML 的核心原则是：数据准备在 Go 层完成，模板只负责展示。抛弃对 sql.Rows 的模板直连幻想，拥抱 []map[string]interface{} 或结构体切片，不仅能彻底解决迭代问题，更能提升代码健壮性、可读性与可维护性。这是 Go Web 开发中“明确优于隐式”的典型体现。
