sqlx 的 mapscan 默认将数据库 text/char 列解析为 []byte 而非 string，导致 json 序列化时被 base64 编码；本文提供安全、可复用的类型转换方案，无需修改底层驱动即可统一转为字符串。
在使用 sqlx.MapScan 查询数据库时，你可能会发现：即使数据库字段是 VARCHAR 或 TEXT 类型，返回的 map[string]interface{} 中对应值却是 []byte 类型（例如 []uint8），而非预期的 string。这并非 sqlx 的 bug，而是 Go 标准库 database/sql 驱动规范所决定的行为——根据 driver.Value 接口定义，查询结果中的字符串默认以 []byte 形式传递（仅在 Rows.Next() 迭代上下文外才允许直接返回 string）。
因此，sqlx.MapScan 严格遵循该规范，将文本列解包为字节切片。当你后续调用 json.Marshal() 时，[]byte 会被自动编码为 Base64 字符串（如 "data:base64,SGVsbG8="），这通常不符合 API 响应需求。
✅ 推荐解决方案：类型安全的 map 字符串转换
以下是一个健壮、可复用的转换函数，它会递归识别并转换 []byte 值为 string，同时保留其他类型不变，并支持嵌套结构（如 map[string]interface{} 中含 slice 或子 map）：
import (
"fmt"
"reflect"
)
// ConvertByteSlicesToStrings 递归地将 map[string]interface{} 中所有 []byte 值转为 string
func ConvertByteSlicesToStrings(m map[string]interface{}) {
for k, v := range m {
switch reflect.TypeOf(v).Kind() {
case reflect.Slice:
if bs, ok := v.([]byte); ok {
m[k] = string(bs)
}
case reflect.Map:
if subMap, ok := v.(map[string]interface{}); ok {
ConvertByteSlicesToStrings(subMap)
}
case reflect.Interface:
// 处理 interface{} 包裹的 []byte（如 scan 后未解包的值）
if rv := reflect.ValueOf(v); rv.Kind() == reflect.Slice && rv.Type().Elem().Kind() == reflect.Uint8 {
if bs := rv.Bytes(); len(bs) > 0 {
m[k] = string(bs)
}
}
}
}
}? 使用示例
rows, err := db.Queryx("SELECT id, name, email FROM users WHERE id = ?", 123)
if err != nil {
log.Fatal(err)
}
defer rows.Close()
for rows.Next() {
m := make(map[string]interface{})
if err := rows.MapScan(&m); err != nil {
log.Printf("scan error: %v", err)
continue
}
// ✅ 关键一步：转换字节切片为字符串
ConvertByteSlicesToStrings(m)
// 现在可安全 JSON 序列化
data, _ := json.Marshal(m)
fmt.Println(string(data)) // {"id":123,"name":"Alice","email":"alice@example.com"}
}⚠️ 注意事项与最佳实践
- 不要依赖 fmt.Sprintf("%s", v) 强转：原答案中 fmt.Sprintf("%s", v) 对 []byte 有效，但对 nil、非字节切片（如 []int）或 string 本身可能引发 panic 或意外行为；上述函数通过 reflect 精确判断 []byte 类型，更安全。
- 避免全局修改：该函数直接修改原 map，若需保留原始数据，请先深拷贝（可用 github.com/mitchellh/copystructure 或自定义浅拷贝逻辑）。
- 考虑替代方案：若项目允许，更推荐使用结构体扫描（db.Get(&user, query)）配合 sql.NullString 或自定义 Scanner 接口实现精确类型控制，语义更清晰、性能更高。
- 驱动层不可控：无法通过 sqlx 或 database/sql 配置强制返回 string —— 这是驱动实现层级的约定，任何绕过反射的手动转换都需在应用层完成。
总之，ConvertByteSlicesToStrings 是一个轻量、可靠、符合 Go 类型习惯的补救方案，能让你在继续使用 MapScan 的灵活性的同时，获得符合直觉的字符串输出。
