本文详解 go 语言中将数据库行数据读取为 map 并追加到 slice 的常见陷阱：因复用同一 map 实例导致所有 slice 元素指向相同内存地址，最终只保留最后一行数据。核心解法是每次循环创建新 map。
本文详解 go 语言中将数据库行数据读取为 map 并追加到 slice 的常见陷阱：因复用同一 map 实例导致所有 slice 元素指向相同内存地址，最终只保留最后一行数据。核心解法是每次循环创建新 map。
在 Go 中处理数据库查询结果时，常希望将每行数据动态映射为 map[string]interface{}（便于支持任意列名与类型），再统一存入 []map[string]interface{} 切片中。但若不注意 Go 的引用语义，极易陷入“所有切片元素内容相同”的典型 bug——正如示例代码所示：myMap 在循环外声明，每次 rows.Next() 都向其写入新值并 append(mySlice, myMap)，结果 mySlice 中所有元素实际指向同一个 map 地址，最终全部显示为最后一行数据。
根本原因在于：Go 中 map 是引用类型（reference type），类似 slice 和 chan。对 myMap 的赋值（如 myMap[key] = val）不会复制底层数据结构，而是在原内存地址上修改；append(mySlice, myMap) 传递的只是该 map 的引用（即 header 指针），而非深拷贝。因此，循环中反复操作的始终是同一块内存。
✅ 正确做法：将 map 创建移至循环内部，确保每行生成独立实例：
for rows.Next() {
// ✅ 每次迭代创建全新 map，隔离数据
rowMap := make(map[string]interface{})
err := rows.Scan(colPtrs...)
if err != nil {
log.Fatal(err)
}
// 将扫描结果按列名填入当前 map
for i, col := range cols {
rowMap[colNames[i]] = col
}
// ✅ 追加的是独立 map 的引用，互不影响
mySlice = append(mySlice, rowMap)
}⚠️ 注意事项：
- 不要复用 cols 切片本身：虽然 cols 是 []interface{}（也是引用类型），但此处它仅作为 Scan 的接收缓冲区，且每次 Scan 会覆盖其内容。只要 colPtrs 指向的地址不变（本例中 &cols[i] 固定），该用法是安全的。
- 类型断言需谨慎：map[string]interface{} 中的值类型取决于数据库驱动返回的实际类型（如 int64, string, []byte 等），后续使用前建议用类型断言或 switch v := val.(type) 处理。
- 资源释放：务必在循环后调用 rows.Close()（推荐用 defer 或 defer rows.Close() 放在 Query 后立即声明），避免连接泄漏。
完整修正后的关键逻辑如下（省略连接部分）：
// 获取列名
colNames, err := rows.Columns()
if err != nil {
log.Fatal(err)
}
cols := make([]interface{}, len(colNames))
colPtrs := make([]interface{}, len(colNames))
for i := range cols {
colPtrs[i] = &cols[i]
}
defer rows.Close() // 确保关闭
var mySlice []map[string]interface{} // 初始化为空切片更安全
for rows.Next() {
if err := rows.Scan(colPtrs...); err != nil {
log.Fatal(err)
}
rowMap := make(map[string]interface{}) // ? 核心：循环内新建
for i, col := range cols {
rowMap[colNames[i]] = col
}
mySlice = append(mySlice, rowMap)
}
// 此时 mySlice 包含每行独立的 map，可安全使用
fmt.Printf("Total rows: %d\n", len(mySlice))总结：Go 的引用语义要求开发者对 map、slice 等类型持有明确的内存所有权意识。处理数据库多行映射时，“循环内创建 map”是简洁、高效且符合 Go 习惯的解决方案。避免全局或外部声明 map，即可彻底规避数据覆盖问题。
