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

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

Cassandra 的 map（即 map(varchar, varchar)）列要求驱动程序接收一个类型安全的 Go 映射值，并由 gocql 驱动自动序列化为 CQL 兼容的二进制格式。你原始代码中传递的是字符串 "{'key' : 'value'}"，gocql 尝试将其作为 string 类型 marshal 到 map，自然失败并报错："can not marshal string into map(varchar, varchar)"。

✅ 正确做法是直接构造 Go 原生映射，并确保键值类型与表 schema 严格一致（例如 map[string]string 对应 map）：

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

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

下载

mapValue := map[string]string{
    "key": "value",
    "status": "active",
    "priority": "high",
}

if err := session.Query(
    "INSERT INTO emergency_records (mapColumn) VALUES (?)",
    mapValue,
).Exec(); err != nil {
    log.Fatal("Failed to insert map:", err)
}

⚠️ 注意事项：

• 类型必须匹配：若 Cassandra 表定义为 map，则需用 map[int]string；若为 map，则用 map[string]int。
• 空 map 合法：可传 map[string]string{}，对应 CQL 中的 {}（空 map），但不可传 nil（gocql 会 panic）。
• 不支持嵌套结构：Cassandra 的 map 是扁平键值对，不支持嵌套 map 或 struct —— 如需复杂结构，请改用 UDT 或 JSON（配合 text 列 + 应用层序列化）。
• 批量插入优化：如需插入多条含 map 的记录，建议复用 session.Query(...).Bind(...).Exec() 或使用 Batch，避免重复解析 CQL。

? 小结：CQL 占位符 ? 不是字符串插值，而是类型感知的参数绑定机制。始终以 Go 原生数据结构（而非字符串表示）传入复合类型，才能让 gocql 正确完成序列化与协议编码。