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

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

Cassandra 的 Go 驱动（如 gocql）在参数绑定阶段会自动将 Go 原生 map 序列化为 CQL 兼容的 : 格式，并确保类型与表定义（如 map）严格一致。而直接传入字符串 "{'key': 'value'}" 会被视为纯文本，驱动无法将其解析为 map 结构，因此报错 can not marshal string into map(varchar, varchar)。

✅ 正确做法是：构造 Go 原生 map 并直接作为参数传递：

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

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

下载

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

⚠️ 注意事项：

• 确保 map 的键值类型与 CQL 表定义完全匹配（例如 map 应传 map[string]int）；
• 不要手动拼接 CQL 字符串（如 "{'k':'v'}"），这不仅导致类型错误，还存在 SQL 注入风险；
• 若需动态构建 map，建议先验证键是否为空或含非法字符（Cassandra 要求 map 键非空且为有效 UTF-8 字符串）；
• 批量插入多个 map 时，可复用同一 map 变量（但需注意引用共享问题，必要时深拷贝）。

总结：Cassandra 驱动依赖 Go 类型系统进行安全、高效的序列化。始终以强类型方式传参——用 map[string]string 代替字符串表示的 map，是解决该类 marshaling 错误的根本原则。