sql.NullString 是带有效标志的 string，结构为 {String string; Valid bool}，必须检查 Valid 才能安全读取 String，它实现 Scanner 和 Valuer 接口但不支持默认 JSON 序列化，适用场景仅限数据库 NULL 与 Go 值映射。
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 {<br> if !n.Valid {<br> return nil<br> }<br> return &n.String<br>}这样后续可直接传给需要*string的函数，避免到处判Valid - 注意：不要用
== ""判断是否为空——NULL 和空字符串在数据库里语义不同，代码里也必须区分
Insert/Update 时，sql.NullString 的 Value 方法自动适配 NULL
往数据库写数据时，sql.NullString 的 Value() 方法会根据 Valid 返回 nil（对应 SQL NULL）或 string 值（对应具体字符串）。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“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) { /* ... */ }sql.NullXXX，应使用 json.RawMessage 或自定义类型 + 接口实现Null 类型的边界很清晰：只解决「数据库 NULL 和 Go 零值之间映射」这一个问题。一旦开始纠结“要不要默认填充”“要不要链式调用”“要不要兼容 ORM”，就已经超出了它的设计职责。
