sqlx 的 mapscan 默认将数据库文本列（如 varchar、text）映射为 []byte 而非 string，导致 json 序列化时被 base64 编码；本文提供安全、通用的类型转换方案，将 map[string]interface{} 中的 []byte 值自动转为可读字符串。
在 Go 中使用 sqlx.MapScan 时，一个常见困惑是：明明数据库字段是 VARCHAR 或 TEXT，但扫描到 map[string]interface{} 后，对应值却表现为 []byte 类型（例如 map["name"] => []byte("alice")），而非预期的 string。这并非 sqlx 的 bug，而是底层 database/sql 驱动的规范行为——根据 Go driver.Value 文档，查询结果中字符串类数据默认以 []byte 形式返回（仅在 Rows.Next() 迭代上下文中才可能优化为 string），目的是避免内存拷贝并支持二进制安全处理。
因此，MapScan 返回的 map[string]interface{} 中，所有文本列实际是 []byte，直接 json.Marshal 会导致不可读的 Base64 编码（如 "name":"YWxpY2U="）。虽然无法通过配置强制 sqlx 改变此行为，但可通过后处理高效、安全地完成转换。
以下是一个健壮的转换函数，它递归识别并转换 []byte 值为 string，同时保留其他类型不变：
import (
"fmt"
"reflect"
)
func ConvertByteSlicesToStrings(m map[string]interface{}) {
for k, v := range m {
// 使用反射判断是否为 []byte
rv := reflect.ValueOf(v)
if rv.Kind() == reflect.Slice && rv.Type().Elem().Kind() == reflect.Uint8 {
if b, ok := v.([]byte); ok {
m[k] = string(b) // 安全转换：仅对 []byte 执行
}
}
}
}✅ 使用示例：
rows, err := db.Queryx("SELECT id, name, email FROM users WHERE id = $1", 123)
if err != nil {
log.Fatal(err)
}
defer rows.Close()
for rows.Next() {
rowMap := make(map[string]interface{})
if err := rows.MapScan(&rowMap); err != nil {
log.Fatal(err)
}
// 转换 []byte → string
ConvertByteSlicesToStrings(rowMap)
// 此时可安全 JSON 序列化
data, _ := json.Marshal(rowMap)
fmt.Println(string(data)) // {"id":123,"name":"alice","email":"alice@example.com"}
}⚠️ 注意事项：
- 不要盲目用 fmt.Sprintf("%s", v)（如原始答案所示），它对非 []byte 类型（如 int、nil）可能产生意外输出（如 "0" 或 "zuojiankuohaophpcnnilyoujiankuohaophpcn"）；应严格检测 []byte 类型。
- 若需处理嵌套结构（如 map[string]interface{} 中含 slice 或子 map），需改写为递归版本。
- 对性能敏感场景，建议优先使用结构体扫描（ScanStruct）或显式类型断言，避免运行时反射开销。
总结：MapScan 的 []byte 行为是 Go SQL 驱动层的设计约定，理解其根源有助于合理选择解决方案——对于动态 schema 场景，后置类型转换是简洁可靠的选择；对于固定 schema，推荐结合 sqlx.StructScan 或自定义 sql.Scanner 实现更优的类型控制。
