Golang Database/SQL处理Null数据_sql.NullString用法详解

P粉602998670

发布时间：2026-02-22 17:09:12

266人浏览过

来源于php中文网

原创

sql.nullstring 是带有效标志的 string，结构为 {string string; valid bool}，必须检查 valid 才能安全读取 string，它实现 scanner 和 valuer 接口但不支持默认 json 序列化，适用场景仅限数据库 null 与 go 值映射。

golang database/sql处理null数据_sql.nullstring用法详解

sql.NullString 不是“能存 null 的 string”，而是“带有效标志的 string”

Go 的 string 类型本身不能为 nil，数据库字段为 NULL 时，直接 scan 到 string 会报错 sql: Scan error on column index 0: unsupported Scan, storing driver.Value type <nil> into type *string</nil>。这时候用 sql.NullString，不是因为它“更灵活”，而是它内部明确区分了「值存在」和「值为 NULL」两种状态。

它的结构很简单：

type NullString struct {<br>    String string<br>    Valid  bool // true 表示 String 字段有意义；false 表示数据库里是 NULL<br>}

必须显式检查 Valid 字段才能安全读取 String，否则可能误把空字符串当 NULL，或把 NULL 当空字符串
sql.NullString 实现了 Scanner 和 Valuer 接口，所以能被 db.QueryRow().Scan() 和 db.Exec() 正常处理
它不支持 JSON 序列化（默认输出是 {"String":"xxx","Valid":true}），需要额外实现 MarshalJSON 才能和前端约定一致

Scan 时直接用 sql.NullString，但别忘了判 Valid

常见错误是扫完就直接用 .String，结果在 NULL 字段上得到空字符串，逻辑出错却难以排查。

正确写法：

var name sql.NullString<br>err := db.QueryRow("SELECT name FROM users WHERE id = ?", 123).Scan(&name)<br>if err != nil { /* handle */ }<br>if name.Valid {<br>    fmt.Println("name is", name.String)<br>} else {<br>    fmt.Println("name is NULL")<br>}

如果业务层希望统一返回指针（比如 *string），可以封装转换：
```
func (n sql.NullString) Ptr() *string { if !n.Valid { return nil } return &n.String }
```
这样后续可直接传给需要 *string 的函数，避免到处判 Valid
注意：不要用 == "" 判断是否为空——NULL 和空字符串在数据库里语义不同，代码里也必须区分

Insert/Update 时，sql.NullString 的 Value 方法自动适配 NULL

往数据库写数据时，sql.NullString 的 Value() 方法会根据 Valid 返回 nil（对应 SQL NULL）或 string 值（对应具体字符串）。

畅图

AI可视化工具

下载

立即学习“go语言免费学习笔记（深入）”；

示例：

name := sql.NullString{String: "", Valid: false} // 表示要插入 NULL<br>// 或<br>name := sql.NullString{String: "Alice", Valid: true} // 表示要插入 "Alice"<br>_, err := db.Exec("INSERT INTO users(name) VALUES(?)", name)

如果传入 Valid == false 但 String 非空，Value() 仍返回 nil —— String 字段此时被忽略，只看 Valid
反模式：不要为了“省事”把用户输入直接赋给 String 却不设 Valid，比如 sql.NullString{String: req.Name} —— 这会让 Valid 保持零值 false，所有非空输入都变成 NULL

还有 sql.NullInt64、sql.NullBool……但别硬套，按需选

database/sql 提供了一组预定义的 Null 类型，但它们只是常见类型的包装，并不覆盖全部需求。

已内置：sql.NullString、sql.NullInt64、sql.NullFloat64、sql.NullBool、sql.NullTime
没有 sql.NullInt32 或 sql.NullUint64？自己定义一个就行，只要实现 Scanner 和 Valuer：

type NullInt32 struct {<br>    Int32 int32<br>    Valid bool<br>}<br><br>func (n *NullInt32) Scan(value interface{}) error { /* ... */ }<br>func (n NullInt32) Value() (driver.Value, error) { /* ... */ }