Go 查询数据库遇到 NULL 怎么接收

从数据库查用户资料时，nickname 允许为 NULL，但 Go 代码直接把它扫描到 string，常见结果是 converting NULL to string is unsupported。这不是 SQL 查询失败，而是数据库驱动返回的空值不能直接转换成普通字符串。

接收可能为 NULL 的字符串，优先使用 sql.NullString，查询结束后先看 Valid，再读取 String。如果项目使用 Go 1.22 及以上，也可以用 sql.Null[string]。只有业务明确要把 NULL 当成某个默认文本时，才在 SQL 中使用 COALESCE。

为什么直接 Scan 到 string 会失败

database/sql 的 Scanner 文档把驱动传来的数据库 NULL 表示为 nil。而 string 没有“未设置”的状态，Scan 无法在不丢失信息的前提下把 nil 存进去，所以会返回转换错误。

var nickname string
err := db.QueryRowContext(ctx,
    "SELECT nickname FROM users WHERE id = ?", userID,
).Scan(&nickname)
if err != nil {
    // nickname 为 NULL 时，通常在这里得到转换错误
    return err
}

先确认查询本身能返回一行，再判断列是否允许 NULL。把 SQL 改成 WHERE nickname IS NOT NULL 只能筛掉数据，不能解决需要读取全部用户的场景。

用 sql.NullString 保留两种空值语义

sql.NullString 有两个字段：String 保存字符串，Valid 表示它是否来自一个非 NULL 值。推荐把判断写在读取边界，避免后面的业务代码到处猜空字符串的含义。

var nickname sql.NullString
err := db.QueryRowContext(ctx,
    "SELECT nickname FROM users WHERE id = ?", userID,
).Scan(&nickname)
if err != nil {
    if errors.Is(err, sql.ErrNoRows) {
        return fmt.Errorf("用户不存在: %w", err)
    }
    return err
}

displayName := "未填写昵称"
if nickname.Valid {
    displayName = nickname.String
}
fmt.Println(displayName)

这里的默认文案只是展示层决定，不会改写数据库值。要特别区分：Valid=false 是 NULL；Valid=true 且 String 为空，是数据库里真的存了空字符串。两者在更新、筛选和接口返回中可能代表不同业务状态。

Rows 查询多个可空字段时怎么写

查询列表时，每一行都要用可空目标接收可能为 NULL 的列。不要把“循环结束”当成成功标志：Scan 可能在中途失败，驱动也可能在迭代结束后才通过 rows.Err 暴露错误。

rows, err := db.QueryContext(ctx, `
    SELECT id, nickname, bio
    FROM users
    ORDER BY id
`)
if err != nil {
    return err
}
defer rows.Close()

type User struct {
    ID       int64
    Nickname string
    Bio      string
}
var users []User
for rows.Next() {
    var id int64
    var nickname, bio sql.NullString
    if err := rows.Scan(&id, &nickname, &bio); err != nil {
        return err
    }
    users = append(users, User{
        ID: id,
        Nickname: nullableText(nickname, "未填写昵称"),
        Bio: nullableText(bio, "暂无简介"),
    })
}
if err := rows.Err(); err != nil {
    return err
}

转换函数可以集中处理默认值：

func nullableText(v sql.NullString, fallback string) string {
    if !v.Valid {
        return fallback
    }
    return v.String
}

如果函数返回前需要确认关闭错误，可以显式调用 rows.Close() 并处理返回值；简单读取场景用 defer 也要保留 rows.Err() 检查。

Go 1.22 及以上可以用 sql.Null[string]

当前 database/sql 还提供泛型 sql.Null[T]，文档标注它自 Go 1.22 加入。字符串列可以这样接收：

var nickname sql.Null[string]
if err := db.QueryRowContext(ctx,
    "SELECT nickname FROM users WHERE id = ?", userID,
).Scan(&nickname); err != nil {
    return err
}
if nickname.Valid {
    fmt.Println(nickname.V)
}

它和 NullString 的核心语义相同：Valid 表示是否为 NULL，值保存在 V。新项目可以用泛型统一字符串、整数等可空字段；需要兼容更早 Go 版本，或已有大量 String 字段的项目，继续使用 sql.NullString 更省迁移成本。T 仍要选择数据库驱动可接受的值类型，不是任意结构体都能直接扫描。

COALESCE 什么时候才适合放进 SQL

如果接口契约明确规定昵称为空时就返回固定文案，可以在查询中写：

SELECT COALESCE(nickname, '') AS nickname
FROM users
WHERE id = ?

这样 Go 侧可以接收 string，但 NULL 和空字符串已经在数据库查询层合并了。搜索“未填写”和搜索“用户主动留空”若有不同含义，就不要用这种写法，保留 sql.NullString 再由领域层决定。

常见问题

*string 能直接接收 SQL NULL 吗？

不要把指针当成通用替代品。具体转换能力受 database/sql 和驱动的 Scanner 规则约束，跨驱动代码使用 sql.NullString 或 sql.Null[string] 更明确。

空字符串和 NULL 最后都想展示为空怎么办？

可以在展示层统一成同一个文案，但建议先保留 Valid，这样更新、审计和筛选仍有机会使用原始语义。

只调用 rows.Next 不检查 rows.Err 可以吗？

不建议。循环结束只说明没有下一行，最终迭代错误还应通过 rows.Err() 判断。

把 NULL 的判断留在数据边界

Go 查询数据库遇到 NULL 时，最稳妥的接收方式是让目标类型显式表达“有值/无值”：旧项目用 sql.NullString，Go 1.22 及以上的新代码可用 sql.Null[string]。先完成 Scan，再在领域或展示层决定默认文案；只有确定业务不需要 NULL 语义时，才用 COALESCE 提前合并。