Go问答：sql.NullString数据库 NULL 扫描后为什么变成空字符串怎样完成一个可复用的最小示例

sql.NullString 扫描数据库 NULL 后，如果只读取 String，就会看到空字符串；NULL 状态保存在 Valid 中。Valid 为 false 时不能把 String 当成有效列值，Valid 为 true 且 String 为空才表示数据库中的有效空字符串。问题通常出在应用层丢掉了 Valid，而非 NullString 无法表示 NULL。

官方地址：https://pkg.go.dev/database/sql#NullString

明确 NULL 与空字符串的区别

以会员昵称为例，“还没填写”和“明确保存为空串”可以是不同业务状态。sql.NullString 包含 String 和 Valid 两个字段；前者承载文本，后者记录是否为非 NULL。Go 的普通 string 没有第三种空状态，所以把可空列直接压成 string，会丢掉信息。

输入域包含 SQL NULL、空字符串与普通文本；扫描域包含 Scan、String 与 Valid。三类输入都关联 Scan，Scan 同时给出 String 和 Valid。解释结果需要这两个字段共同参与，不能用 String 的长度推断 NULL。

准备不连接数据库的最小示例

下面直接调用 NullString.Scan，使用 nil 模拟 SQL NULL 的扫描输入。保存为 main.go 即可自行使用，只需要标准库。它说明 Scanner 对值的表达，不假装执行过真实数据库查询。

package main

import (
    "database/sql"
    "encoding/json"
    "fmt"
)

type Output struct {
    Nickname *string `json:"nickname"`
}

// nullableText 在业务输出层保留 NULL 与空串的差别。
func nullableText(n sql.NullString) *string {
    if !n.Valid {
        return nil
    }
    value := n.String
    return &value
}

func main() {
    // 直接调用 Scanner，独立演示 nil、空串和普通文本，无需数据库驱动。
    inputs := []any{nil, "", "访客甲"}
    for _, input := range inputs {
        var n sql.NullString
        if err := n.Scan(input); err != nil {
            fmt.Printf("扫描失败：%v\n", err)
            continue
        }
        // 读取 Valid 后再解释 String，避免抹掉 NULL 状态。
        data, err := json.Marshal(Output{Nickname: nullableText(n)})
        if err != nil {
            fmt.Printf("序列化失败：%v\n", err)
            continue
        }
        fmt.Printf("Valid=%t String=%q 输出=%s\n", n.Valid, n.String, data)
    }
}

按接口语义，nil 对应 Valid=false；空串对应 Valid=true、String 为空；普通文本对应 Valid=true 且保留文本。示例打印两个字段，能帮助读者发现“只看字符串”造成的信息丢失。这里没有提供本机实际输出或伪造日志。

NullString 的零值也表示无有效字符串。若程序没有成功调用 Scan 就开始读取字段，看到零值不能说明数据库返回了 NULL。必须先确认扫描调用本身成功。

映射为业务可空值

示例中的 nullableText 在 Valid=false 时返回 nil，否则返回指向文本值的指针。Output.Nickname 因此可以区分 JSON null、JSON 空字符串和普通字符串。字段没有加 omitempty，避免 nil 指针导致整个 nickname 键被省略。这是接口契约选择；如果业务要求省略字段，应明确说明“缺省”与 null 的含义。

存储分组包含 sql.NullString、String 和 Valid；响应分组包含 nullableText、Nickname 与 JSON null。NullString 拥有 String 与 Valid，映射函数读取它们，Nickname 接收映射值，空指针在此响应结构中对应 JSON null。直接把 sql.NullString 结构体作为 JSON 数据暴露，通常会输出内部字段对象，而不会自动变成 JSON null。

不要为了让前端“好处理”无条件把 NULL 转为空串，除非产品定义本来就合并这两种状态。一旦合并，后续无法从响应字符串恢复原始含义。需要回写数据库时，也要同时设置 String 和 Valid；仅写 String 而保持 Valid=false，不会表达有效文本。

接入 Row.Scan 并处理错误

已有数据库连接池后，可以在查询代码中把 NullString 的地址作为 Scan 目标。下面是集成片段，假设 ctx、db、memberID 和 useNickname 由应用提供；问号占位符是否可用取决于驱动，不能直接套到所有数据库。

// db 为已初始化的连接池；占位符语法须与实际数据库驱动一致。
var nickname sql.NullString
err := db.QueryRowContext(ctx,
    "SELECT nickname FROM members WHERE id = ?", memberID,
).Scan(&nickname)
if err != nil {
    // 包括 sql.ErrNoRows；此处失败时不读取 nickname 作为业务结果。
    return err
}
if !nickname.Valid {
    // 这里表示行存在，但 nickname 列是 SQL NULL。
    return nil
}
useNickname(nickname.String) // 空字符串也可以是有效列值。

sql.ErrNoRows 表示没有查询到行，Valid=false 表示成功读取的一行中该列为 NULL，两者不能合并处理。查询错误、类型转换错误也必须先返回，不能把失败后的零值带给接口层。

若读取多行，QueryContext 成功后由调用者关闭 Rows，在循环中分别检查 Scan 错误，循环结束后检查 Rows.Err。查询层只负责保留状态，展示层决定如何表达；不要在扫描时就用固定默认昵称覆盖原值。

扩展输入与状态速查

可继续自行添加 []byte 文本输入，观察驱动常见的文本来源与最终字符串的关系；不要把带类型的 nil 切片随意当成 SQL NULL 的等价表达。这里用于模拟 NULL 的输入是无类型 nil 转成的空接口值。最小示例没有外部连接、文件或临时目录，因此无需额外清理资源。

用 COALESCE 把 NULL 变空串可以吗？

如果业务明确不需要区分，可以在查询层合并；但此时扫描结果已经是查询表达式的结果，NullString 无法再恢复原列是否为 NULL。具体 SQL 语法应依据数据库文档。

Valid=false 就代表扫描失败吗？

不代表。成功扫描 NULL 时也为 false。调用是否成功由 error 判断，列值是否有效由 Valid 判断。

为什么写入 String 后仍保存成 NULL？

检查 Valid 是否仍为 false。通过 NullString 的 Value 接口回写时，有效性是决定是否表达 NULL 的关键部分。

接口依据为 Go 官方 database/sql 文档：https://pkg.go.dev/database/sql#NullString、https://pkg.go.dev/database/sql#NullString.Scan、https://pkg.go.dev/database/sql#NullString.Value。