在 go 中使用 cassandra 客户端插入 map 类型字段时，必须传入原生 go map[string]string（或匹配的 map 类型），而非 json 字符串或带引号的字符串字面量，否则会触发类型不匹配错误。

在 go 中使用 cassandra 客户端插入 map 类型字段时，必须传入原生 go map[string]string（或匹配的 map 类型），而非 json 字符串或带引号的字符串字面量，否则会触发类型不匹配错误。

Cassandra 的 Go 驱动（如 gocql）在参数化查询中会对值进行类型推断与序列化。当你写成：

"{'key' : 'value'}"

驱动将其识别为 string 类型，而目标列 mapColumn 在表结构中定义为 map，因此抛出错误：can not marshal string into map(varchar, varchar)。

✅ 正确做法是直接传递 Go 原生 map：

使用Go语言搭建家庭相册系统-相关课件

使用Go语言搭建家庭相册系统-相关课件

下载

mapValue := map[string]string{"key": "value"}
if err := session.Query(
    "INSERT INTO emergency_records (mapColumn) VALUES (?)",
    mapValue,
).Exec(); err != nil {
    log.Fatal("Insert failed:", err)
}

⚠️ 注意事项：

• 确保 map 的键值类型与 CQL 表定义严格一致（例如 map 应传 map[string]int）；
• 不支持嵌套 map（Cassandra 本身不支持嵌套集合类型）；
• 若需动态构造 map，推荐使用变量赋值而非内联字面量，以提升可读性与可维护性；
• 批量插入多个 map 时，每个参数仍需独立传入对应 map 实例，不可复用同一引用（除非明确允许并发写入）。

? 小技巧：可通过 session.Query(...).Bind(mapValue).Exec() 显式绑定，语义更清晰；若 map 为空（nil），Cassandra 将插入 null —— 如需空 map，请用 make(map[string]string) 初始化。

总之，Cassandra 驱动依赖 Go 值的运行时类型完成序列化，而非字符串解析。放弃手动拼接 CQL 字符串，拥抱类型安全的参数传递，是避免此类错误的根本原则。