Golang处理SQL空值详解

本文深入剖析了 Go 语言中 `sql.NullString` 等数据库空值处理类型的本质与正确用法：它并非“可为空的字符串”，而是一个显式携带 `Valid` 标志的结构体，专为精准映射 SQL 的 `NULL` 语义与 Go 的零值差异而生；文章不仅厘清了常见误区（如误用 `== ""` 判断、忽略 `Valid` 检查导致逻辑错误），还详解了其 `Scanner`/`Valuer` 接口实现原理、JSON 序列化陷阱、安全读写模式、指针封装技巧，以及如何按需扩展自定义 `Null` 类型——帮你避开生产环境中最隐蔽、最难排查的空值逻辑坑。

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

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

它的结构很简单：

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

• 必须显式检查 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
  err := db.QueryRow("SELECT name FROM users WHERE id = ?", 123).Scan(&name)
  if err != nil { /* handle */ }
  if name.Valid {
      fmt.Println("name is", name.String)
  } else {
      fmt.Println("name is NULL")
  }

• 如果业务层希望统一返回指针（比如 *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 值（对应具体字符串）。

• 示例：

  name := sql.NullString{String: "", Valid: false} // 表示要插入 NULL
  // 或
  name := sql.NullString{String: "Alice", Valid: true} // 表示要插入 "Alice"
  _, 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 {
    Int32 int32
    Valid bool
}

func (n *NullInt32) Scan(value interface{}) error { /* ... */ }
func (n NullInt32) Value() (driver.Value, error) { /* ... */ }

Null 类型的边界很清晰：只解决「数据库 NULL 和 Go 零值之间映射」这一个问题。一旦开始纠结“要不要默认填充”“要不要链式调用”“要不要兼容 ORM”，就已经超出了它的设计职责。

好了，本文到此结束，带大家了解了《Golang处理SQL空值详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！