本文详解 Go 语言中使用 sql.Rows 读取数据库记录时，如何避免因复用同一 map 实例导致切片中所有元素都指向最后一行数据的常见陷阱，并提供安全、可复用的实现方案。
本文详解 go 语言中使用 `sql.rows` 读取数据库记录时，如何避免因复用同一 map 实例导致切片中所有元素都指向最后一行数据的常见陷阱，并提供安全、可复用的实现方案。
在 Go 中处理数据库查询结果时，一个高频误区是：在循环外部声明一个 map 变量，并在每次 rows.Next() 迭代中反复更新它，再将其地址（即引用）追加到 []map[string]interface{} 切片中。由于 Go 的 map 是引用类型（底层指向哈希表结构体的指针），mySlice = append(mySlice, myMap) 实际上是将同一个 map 的引用多次存入切片——最终切片中所有元素都指向内存中同一块数据，因此打印或使用时只会看到最后一条记录的值。
根本原因在于：你并未创建新 map，而是一直在修改旧 map 的内容。解决方法非常明确：确保每次迭代都创建一个全新的 map 实例。
以下是修正后的完整示例代码（已移除硬编码连接字符串，增强健壮性与可读性）：
package main
import (
"database/sql"
"fmt"
"log"
"reflect"
_ "github.com/lib/pq" // PostgreSQL 驱动
)
func main() {
fmt.Println("Go 数据库行转 map 切片实践")
// 1. 建立数据库连接（生产环境请使用连接池配置）
db, err := sql.Open("postgres", "user=postgres dbname=proj2-dbcruddb-dev password=12345 sslmode=disable")
if err != nil {
log.Fatalln("数据库连接失败:", err)
}
defer db.Close() // 注意：应 defer db.Close() 而非 rows.Close()（后者由 Query 自动管理）
// 2. 执行查询
rows, err := db.Query("SELECT id, username, password FROM userstable")
if err != nil {
log.Fatal("查询执行失败:", err)
}
defer rows.Close()
// 3. 获取列名
colNames, err := rows.Columns()
if err != nil {
log.Fatal("获取列名失败:", err)
}
// 4. 为每列准备扫描目标（需在循环外初始化一次）
cols := make([]interface{}, len(colNames))
colPtrs := make([]interface{}, len(colNames))
for i := range cols {
cols[i] = new(interface{}) // 每个元素分配独立的 interface{} 指针
colPtrs[i] = cols[i]
}
// 5. 核心逻辑：逐行扫描 → 构建新 map → 追加至切片
var result []map[string]interface{}
for rows.Next() {
// ✅ 关键修复：每次迭代都创建全新 map
rowMap := make(map[string]interface{})
// 扫描当前行数据
if err := rows.Scan(colPtrs...); err != nil {
log.Fatal("行扫描失败:", err)
}
// 将扫描结果按列名填入 map
for i, col := range cols {
// col 是 *interface{}，需解引用获取实际值
rowMap[colNames[i]] = *(col.(*interface{}))
}
result = append(result, rowMap)
// 可选：调试输出
fmt.Printf("已添加行: %+v\n", rowMap)
}
if err := rows.Err(); err != nil {
log.Fatal("遍历 rows 时出错:", err)
}
fmt.Printf("\n✅ 最终结果共 %d 行:\n", len(result))
for i, m := range result {
fmt.Printf("第 %d 行: %+v\n", i+1, m)
}
}? 关键注意事项与最佳实践：
- 永远不在循环外复用 map：map 是引用类型，append(slice, myMap) 存的是引用，不是副本。务必在 for rows.Next() 内部调用 make(map[string]interface{})。
- cols 切片中的每个元素必须是独立指针：原代码中 cols[i] = &cols[i] 是错误的（会导致所有指针指向同一地址）。正确做法是 cols[i] = new(interface{}) 或使用 &cols[i] 但需确保 cols 元素本身是可寻址的变量（推荐前者更清晰）。
- 及时检查 rows.Err()：rows.Next() 返回 false 后，应显式调用 rows.Err() 确认是否因错误终止，避免静默失败。
- 资源释放优先级：db 应 defer db.Close()；rows 在 Query 后自动管理，但显式 defer rows.Close() 更稳妥（尤其当 rows 可能提前退出时）。
- 类型安全提醒：interface{} 会丢失原始类型信息（如 int64, string）。如需强类型，建议定义结构体 + sqlx.StructScan 或 pgx 等高级驱动。
✅ 总结：Go 中处理动态列数据库结果的核心原则是——“一行一 map，一 map 一实例”。只要坚持在循环内构造新 map，并正确管理扫描指针，即可安全、高效地构建结构灵活的映射切片，为 JSON 序列化、通用 API 响应等场景打下坚实基础。
