Go database/sql 扫描 NULL 到 string 为什么报错

在 Go 中，查询结果里的 SQL NULL 不是空字符串。把它直接扫描到 string 时，database/sql 无法把“没有值”转换成一个确定的字符串，于是常见报错会落在 converting NULL to string is unsupported。修复重点不是把报错吞掉，而是先决定这个字段是否需要保留“缺失”状态。

如果列允许 NULL 且业务需要区分“没有值”和“值为空”，优先使用 sql.NullString；如果只想把 NULL 展示成默认文本，可以在 SQL 中使用 COALESCE；只有确认字段永远非空时，才直接扫描到 string。

先分清 NULL、空字符串和默认文本

NULL 表示未知或不存在的值，'' 是一个长度为 0 的字符串，而 COALESCE 产生的默认文本是查询阶段主动选择的结果。三者在列表展示上可能看起来相似，但在更新、筛选和审计时含义不同。

例如，用户没有填写简介时可能应该显示“未填写”，但这不代表数据库里已经保存了空字符串。若把两种状态过早合并，后续就无法判断用户是否真正提交过空内容。

用 sql.NullString 保留字段是否存在

sql.NullString 包含 String 和 Valid 两个关键信息。扫描成功后，Valid=false 表示来源是 NULL；当来源是普通字符串时，Valid=true，即使字符串内容恰好为空也一样。

package main

import (
    "context"
    "database/sql"
    "fmt"
)

type User struct {
    ID   int64
    Bio  sql.NullString
}

func loadUser(ctx context.Context, db *sql.DB, id int64) (User, error) {
    var user User
    // 把可空列扫描到 NullString，保留 NULL 对应的 Valid 状态。
    err := db.QueryRowContext(ctx,
        `SELECT id, bio FROM users WHERE id = ?`, id,
    ).Scan(&user.ID, &user.Bio)
    if err != nil {
        // 查询不到记录和连接错误都交给调用方决定如何处理。
        return User{}, fmt.Errorf("load user %d: %w", id, err)
    }
    return user, nil
}

func displayBio(bio sql.NullString) string {
    // 展示层只在这里决定 NULL 的文案，不改变数据层语义。
    if !bio.Valid {
        return "未填写"
    }
    return bio.String
}

这段代码把“是否有值”的判断留在领域对象附近，调用方可以根据 Valid 决定展示、更新或序列化策略。不要只读取 String 而忽略 Valid，否则仍会丢失 NULL 与空字符串的区别。

什么时候用 *string 或 COALESCE

如果 Go 结构体需要表达三态，可以把目标写成 *string：非 NULL 得到指向字符串的指针，NULL 保持为 nil。这种表示适合 JSON 响应、补丁更新或需要让调用方明确处理缺失值的接口。

var bio *string

// 指针为 nil 表示 SQL NULL；非 nil 时才读取实际字符串。
if err := row.Scan(&bio); err != nil {
    return err
}
if bio == nil {
    fmt.Println("未填写")
} else {
    fmt.Println(*bio)
}

如果业务明确规定查询结果只用于展示，并且 NULL 与某个默认值完全等价，也可以让 SQL 完成转换：

SELECT id,
       -- 只在展示查询中把 NULL 映射为默认文本。
       COALESCE(bio, '') AS bio
FROM users
WHERE id = ?;

这会让 string 能够接收结果，但也同时隐藏了列原本是否为 NULL。写入、审计和条件更新场景不要为了省一个判断就使用它。

把 rows 生命周期和错误处理放在一起

处理多行数据时，扫描类型只是其中一环。要在拿到 rows 后立即 defer rows.Close()，循环中检查 Scan 错误，循环结束后再检查 rows.Err()。这样才能区分单行转换失败和迭代过程中的底层错误。

func listUsers(ctx context.Context, db *sql.DB) ([]User, error) {
    rows, err := db.QueryContext(ctx, `SELECT id, bio FROM users ORDER BY id`)
    if err != nil {
        return nil, err
    }
    // 及时关闭结果集，避免连接和游标长期占用。
    defer rows.Close()

    users := make([]User, 0)
    for rows.Next() {
        var user User
        // Scan 只负责把每一行映射到保留 NULL 语义的对象。
        if err := rows.Scan(&user.ID, &user.Bio); err != nil {
            return nil, err
        }
        users = append(users, user)
    }
    // Next 结束不等于没有错误，必须读取迭代器状态。
    if err := rows.Err(); err != nil {
        return nil, err
    }
    return users, nil
}

常见边界：空串、默认值和字段约束

可以用下面的规则快速选择：

还要注意：字段声明为 NOT NULL 不等于历史数据、视图或外连接结果永远不会产生 NULL。只要查询本身可能返回 NULL，就按查询结果的真实语义选择扫描目标。

相关问题

把 NULL 扫描到 []byte 可以吗？

是否可行取决于驱动对目标类型的转换支持，不应把它当作跨驱动的通用方案。需要稳定表达可空文本时，使用 sql.NullString 或 *string 更清楚。

能不能用 COALESCE 解决所有报错？

它只能改变当前查询的结果，不会修正写入模型或其他查询。只有当默认值与业务语义确实等价时才使用，否则会把缺失信息静默丢掉。