Go database/sql NullString 如何区分空字符串和 NULL

查询用户简介、备注或可选配置时，数据库里的 NULL 和 '' 都可能被业务描述成“没有内容”，但它们不是同一种状态。前者表示没有值，后者表示值存在，只是长度为零。Go 的 database/sql 直接把结果扫进 string 时，遇到 NULL 往往会失败；正确做法是用 sql.NullString 保存文本和有效标记。

判断顺序只有一句：先看 Valid，再读 String。Valid=false 是数据库 NULL；Valid=true 且 String=="" 才是空字符串。

先把 NULL 和空字符串当成两种数据状态

以 users.nickname 为例，允许 NULL 的字段至少有三种可观察状态：NULL、空字符串和普通字符串。业务上如果“未填写”和“用户主动清空”需要不同处理，就不能在 SQL 或 DTO 层提前用 COALESCE 抹平差异。先确认字段定义和业务约定，再决定是否保留三态。

用 sql.NullString 扫描单行文本

NullString 同时实现了 sql.Scanner 和 driver.Valuer。单行查询时把它的地址传给 Scan，不要先把目标声明成普通字符串：

package main

import (
    "database/sql"
    "fmt"
)

func readNickname(db *sql.DB, id int64) (string, bool, error) {
    var nickname sql.NullString
    // 让 Scanner 保留 NULL 与空字符串的差异。
    err := db.QueryRow("SELECT nickname FROM users WHERE id = ?", id).Scan(&nickname)
    if err != nil {
        // ErrNoRows 与数据库连接、扫描错误应交给上层分别处理。
        return "", false, err
    }
    if !nickname.Valid {
        // Valid=false 只表示源列为 NULL，不要把它当作普通空串。
        return "", false, nil
    }
    // Valid=true 时，即使 String 为空，也要保留“值存在”的信息。
    return nickname.String, true, nil
}

func show(value string, valid bool) {
    // valid 是三态映射中的关键标记，不能省略。
    if !valid {
        fmt.Println("nickname is NULL")
        return
    }
    fmt.Printf("nickname=%q\\n", value)
}

这里返回 (string, bool, error)，比只返回一个字符串更诚实：布尔值记录是否为 NULL，错误值则记录查询或扫描是否成功。若接口层需要 JSON 的 null，可以在 DTO 映射时根据这个布尔值输出指针或 sql.NullString 对应的自定义字段。

在 Rows 循环中保留每行的有效标记

批量读取时，关键不是复用一个字符串，而是每一行都明确判断 Valid，并在循环结束后检查 rows.Err()。下面的结果结构刻意保留 NicknameValid：

type UserName struct {
    ID            int64
    Nickname      string
    NicknameValid bool
}

func readUsers(db *sql.DB) ([]UserName, error) {
    rows, err := db.Query("SELECT id, nickname FROM users ORDER BY id")
    if err != nil {
        return nil, err
    }
    // rows 持有连接和结果集资源，函数返回前必须关闭。
    defer rows.Close()

    var result []UserName
    for rows.Next() {
        var item UserName
        var nickname sql.NullString
        // Scan 错误不能被忽略，否则一行坏数据会变成不完整对象。
        if err := rows.Scan(&item.ID, &nickname); err != nil {
            return nil, err
        }
        item.Nickname = nickname.String
        item.NicknameValid = nickname.Valid
        result = append(result, item)
    }
    // Next=false 既可能是读完，也可能是迭代过程发生错误。
    if err := rows.Err(); err != nil {
        return nil, err
    }
    return result, nil
}

注意不要用 strings.TrimSpace 后再判断是否为空来替代 Valid。那会把数据库事实和业务清洗规则混在一起；如果确实要把全空白昵称视为未填写，应在保留 Valid 后再单独制定规则。

写回时用 Valid 决定 NULL 还是字符串

NullString.Value() 会根据 Valid 选择写回的驱动值：无效值对应 NULL，有效值对应 String。因此更新昵称时，先把业务输入翻译成明确的 NullString：

func updateNickname(db *sql.DB, id int64, nickname *string) error {
    var value sql.NullString
    if nickname != nil {
        // 指针非 nil 表示要保存一个值，空字符串也要原样保留。
        value = sql.NullString{String: *nickname, Valid: true}
    }
    // 指针为 nil 时 Valid=false，driver 会收到 NULL。
    _, err := db.Exec("UPDATE users SET nickname = ? WHERE id = ?", value, id)
    return err
}

如果使用 database/sql 较新的泛型 sql.Null[string]，它表达的是同一类“值加 Valid”模型；为了兼容仍广泛使用的代码，sql.NullString 依然是直观选择。不要把 NullString{String: "", Valid: false} 误当成“保存空字符串”，它表达的是 NULL。

把数据库三态映射到接口响应

最容易漏掉的一层是 JSON 响应。若直接把 NullString.String 填入响应结构，NULL 和空字符串都会变成 ""。可以用指针显式保留语义：

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

func toResponse(value sql.NullString) UserResponse {
    // NULL 映射为 nil，JSON 编码时可按结构约定输出 null。
    if !value.Valid {
        return UserResponse{}
    }
    // 有效的空字符串仍返回非 nil 指针，避免与 NULL 混淆。
    nickname := value.String
    return UserResponse{Nickname: &nickname}
}

发布前可以按下面清单做一次针对性回归：查询一条 NULL、一条空串和一条普通文本；确认三条记录的 Valid 分别为 false、true、true；再分别写回 nil、空串和普通文本，检查数据库中的结果是否保持原样。这里验证的是数据语义，不是把所有空值都统一成同一种展示。

常见问题

只判断 NullString.String == "" 可以吗？

不可以。NULL 和空字符串都可能得到空文本，必须同时判断 Valid。

为什么直接 Scan 到 string 会报错？

数据库驱动给 NULL 的源值是 nil，普通 string 没有位置保存“无值”状态，所以应改用实现 Scanner 的 NullString。

Valid=true 但 String为空是不是异常？

不是。这正是数据库空字符串的正常表示，是否把它当作未填写应由业务规则另行决定。