如何避免切片中多个 map 引用同一内存块

梦明小哥_1575

发布时间：2026-04-08 08:43:04

584人浏览过

来源于php中文网

原创

在 Go 中使用 sql.Rows.Scan 配合 []sql.RawBytes 时，若未正确处理底层字节引用，会导致多次 append 到切片的 map[string]interface{} 实际共享同一份 RawBytes 数据，造成所有 map 显示相同内容。

在 go 中使用 `sql.rows.scan` 配合 `[]sql.rawbytes` 时，若未正确处理底层字节引用，会导致多次 `append` 到切片的 `map[string]interface{}` 实际共享同一份 `rawbytes` 数据，造成所有 map 显示相同内容。

这个问题的根本原因在于：sql.RawBytes 是一个零拷贝的字节切片引用类型——它不持有数据副本，而是直接指向 rows.Scan 内部缓冲区中的原始内存地址。每次调用 rows.Next() + rows.Scan() 时，vals 切片中的 sql.RawBytes 会被复用并覆盖，而你存入 m[cols[i]] = vals[i] 的是 sql.RawBytes 本身（即一个 []byte header），其底层数组指针始终指向同一块被反复写入的内存。

因此，尽管你为每个循环创建了新的 map[string]interface{}（m := make(map[string]interface{})），但其中存储的 sql.RawBytes 值仍指向同一缓冲区；当后续行扫描覆盖 vals 时，之前所有 map 中的 RawBytes 内容也随之“静默更新”，最终 res 中所有 map 显示最后一行的数据。

✅ 正确做法：显式拷贝字节数据

你需要将 sql.RawBytes 转换为独立拥有的 []byte（即深拷贝），再存入 map：

for i := range vals {
    // ✅ 安全拷贝：创建新底层数组，与 rows 缓冲区解耦
    if len(vals[i]) > 0 {
        copied := make([]byte, len(vals[i]))
        copy(copied, vals[i])
        m[cols[i]] = copied
    } else {
        m[cols[i]] = []byte{} // 或 nil，根据业务需要
    }
}

? 补充说明：sql.RawBytes 的文档明确指出：“If an argument has type `RawBytes, Scan saves a reference to the underlying data — the caller must not modify or retain it beyond the next call toNext`.*” 这正是问题根源。

? 更简洁、推荐的替代方案（避免 RawBytes）

如果你不需要零拷贝优化（绝大多数 Web/API 场景都不需要），*直接使用 `interface{}或具体类型（如string,int64）作为 scan 目标**，让database/sql` 自动完成安全转换和内存分配：

func ResultRows(rows *sql.Rows, limit int) (DBResult, error) {
    cols, err := rows.Columns()
    if err != nil {
        return nil, err
    }

    // 使用 interface{} 指针数组，让 Scan 自动分配并复制值
    scanArgs := make([]interface{}, len(cols))
    for i := range scanArgs {
        scanArgs[i] = new(interface{}) // 每个字段独立分配
    }

    res := make(DBResult, 0, limit)
    for rows.Next() && len(res) < limit {
        if err := rows.Scan(scanArgs...); err != nil {
            return nil, err
        }

        m := make(map[string]interface{})
        for i, col := range cols {
            // ✅ 自动解包：scanArgs[i] 指向已拷贝的值，安全持久
            val := *(scanArgs[i].(*interface{}))
            m[col] = val
        }
        res = append(res, m)
    }

    return res, rows.Err()
}

该方式无需手动管理字节拷贝，语义清晰，且天然规避引用复用问题；性能损耗可忽略（现代 GC 对小对象高效），是生产环境更健壮的选择。