本文介绍在 Go（Golang）中使用 database/sql 操作 MySQL 时，如何将 Go 的空字符串（""）自动映射为数据库中的 NULL，而非默认插入空值，核心是借助 sql.NullString 类型及封装辅助函数实现安全、可读、可复用的空值处理。
本文介绍在 go（golang）中使用 `database/sql` 操作 mysql 时，如何将 go 的空字符串（""）自动映射为数据库中的 null，而非默认插入空值，核心是借助 sql.nullstring 类型及封装辅助函数实现安全、可读、可复用的空值处理。
在 Go 的标准数据库驱动中，string 是非空类型，无法直接表示 SQL 的 NULL；若直接传入空字符串 ""，MySQL 会将其作为字面量插入（即存储为空串），而非 NULL。要实现“空字符串 → SQL NULL”的语义转换，必须显式使用 sql.NullString——它是 Go 标准库提供的可空字符串类型，包含两个字段：String string 和 Valid bool。仅当 Valid == true 时，String 值才被写入数据库；否则底层驱动将其序列化为 NULL。
为此，推荐定义一个简洁、幂等的转换函数：
import "database/sql"
func NewNullString(s string) sql.NullString {
if s == "" {
return sql.NullString{} // Valid=false, String="" → INSERTs as NULL
}
return sql.NullString{
String: s,
Valid: true,
}
}
注意：sql.NullString{} 的零值天然满足 Valid == false，因此无需显式初始化 Valid: false。
接着，在你的 Exec 调用中，将所有可能为空、且业务语义上应存为 NULL 的字符串字段（如 ve.EventInfo、ve.UrlPath、ve.Domain 等）统一包裹进 NewNullString()：
_, err := m.Db.Exec(`INSERT INTO
visitor_events
(type,
info,
url_path,
visitor_id,
created_at,
domain)
VALUES (?, ?, ?, ?, ?, ?)`,
m.SaveEventType(ve),
NewNullString(ve.EventInfo), // ← 替换原 ve.EventInfo
NewNullString(m.SaveURLPath(ve.UrlPath)), // ← 替换原 m.SaveURLPath(ve.UrlPath)
ve.VisitorId,
time.Now().UTC(),
NewNullString(ve.Domain), // ← 替换原 ve.Domain
)
if err != nil {
// handle error
}
✅ 关键注意事项：
- 数据库对应字段（如
info、url_path、domain）必须允许为 NULL（即建表时定义为VARCHAR(...) NULL），否则插入会报错Error 1048: Column 'xxx' cannot be null； -
sql.NullString仅适用于string类型字段；其他可空类型（如int、time.Time）需分别使用sql.NullInt64、sql.NullTime等，并配套编写对应转换函数； - 若字段在业务逻辑中 永远不应为 NULL（例如
visitor_id），则切勿对其调用NewNullString，否则可能意外插入NULL导致数据异常或查询失效； - 该方案完全兼容
mysql驱动（如github.com/go-sql-driver/mysql），无需额外配置。
通过这一模式，你既保持了代码的清晰性与一致性，又确保了数据库语义的准确性：空字符串不再被误存为无意义的 ""，而是正确表达“值未知/未提供”的业务意图。
