
在 go 中使用 database/sql 扫描多行数据时,若重复复用同一字符串切片(如 result)并追加到二维切片中,会导致所有行引用同一底层数组,从而造成后扫描的行覆盖先前数据——根本原因在于 Go 切片的引用语义。
在 go 中使用 database/sql 扫描多行数据时,若重复复用同一字符串切片(如 `result`)并追加到二维切片中,会导致所有行引用同一底层数组,从而造成后扫描的行覆盖先前数据——根本原因在于 go 切片的引用语义。
这是一个在 Go 数据库编程中高频出现的典型陷阱:误将可变切片当作值类型使用。你的代码中定义了全局 result := make([]String, len(cols)),并在每次循环中反复修改它,再执行 results = append(results, result)。由于 result 是一个切片头(包含指向底层数组的指针、长度和容量),append 操作实际存入 results 的是多个指向同一底层数组的切片头。因此,后续对 result[i] 的赋值会持续覆盖该数组内容,最终 results 中所有子切片都显示最后一行的数据。
✅ 正确做法是:为每一行创建独立的、内存隔离的字符串切片。只需将 result := make([]string, len(cols)) 移入 for rows.Next() 循环内部即可:
var results [][]string cols, _ := rows.Columns() // 假设已获取列名(或提前已知列数) for rows.Next() { rawResult := make([]interface{}, len(cols)) dest := make([]interface{}, len(cols)) for i := range rawResult { dest[i] = &rawResult[i] } if err := rows.Scan(dest...); err != nil { log.Fatal("Failed to scan row:", err) } // ✅ 每次循环新建独立切片 → 内存隔离,彻底避免覆盖 result := make([]string, len(cols)) for i, raw := range rawResult { switch v := raw.(type) { case int64: result[i] = strconv.FormatInt(v, 10) case float64: result[i] = strconv.FormatFloat(v, 'f', -1, 64) case bool: result[i] = strconv.FormatBool(v) case []byte: result[i] = string(v) case string: result[i] = v case time.Time: result[i] = v.String() case nil: result[i] = "" default: log.Fatalf("Unexpected type %T in column %d", v, i) } } results = append(results, result) // 现在 append 的是全新、独立的切片 }
? 关键原理说明:
- make([]string, n) 分配新的底层数组,每个 result 拥有专属内存空间;
- 即使 results 是 [][]string,其每个元素(即 result)现在都指向不同地址,互不影响;
- 不要试图通过 append(results, append([]string(nil), result…)) 等“浅拷贝”技巧绕过——那只是冗余操作,而新建切片才是语义清晰、性能可控的正解。
⚠️ 额外注意事项:
- 若数据量极大(如百万级行),频繁 make 可能带来 GC 压力,此时可考虑预分配 results 容量(results := make([][]string, 0, expectedRowCount))或使用对象池(sync.Pool)复用 []string,但需严格保证线程安全与生命周期管理;
- 生产环境建议使用结构体(Struct)替代 []string 存储行数据,提升类型安全与可读性(例如 type User struct { ID int; Name string } + rows.Scan(&u.ID, &u.Name));
- 务必调用 rows.Err() 检查扫描结束后的潜在错误(如网络中断),并在循环后关闭 rows。
掌握切片的引用本质,是写出健壮 Go 数据层代码的第一课——永远记住:复用切片头 ≠ 复用数据,新建切片 = 新建契约。