Go Scan NULL 到普通字符串为什么报错

你用Go操作数据库调用Scan方法，把数据库里的NULL值直接扫描到普通string变量上报错，是标准库的预设强类型校验逻辑导致的，并不是你写的代码哪里写错了。

这个报错属于database/sql标准库的正常设计，目的是避免开发者在无感知的情况下丢失数据库NULL值的特殊标识，不会自动隐式把NULL转成空字符串赋值。

这类错误的根因不是字符串内容异常，而是数据库列返回了 NULL。database/sql 会把它交给扫描目标的源值表示为 nil，而普通 Go 字符串只能表示一个具体文本，不能同时表达“没有值”，所以 Scan(&name) 会报转换错误。

官方文档：https://pkg.go.dev/database/sql

需要保留 NULL 语义时，把目标改成 sql.NullString 或 sql.Null[string]；只有业务明确把 NULL 当成空文本时，才在 SQL 中用 COALESCE 做转换。

先看清 Scan 的输入和报错位置

Rows.Scan 的源值可能是 int64、[]byte、string、time.Time 或代表 SQL NULL 的 nil。当目标是 *string 时，database/sql 的转换逻辑无法把 nil 无损地写进字符串，因此常见错误会包含“converting NULL to string is unsupported”。这和列中存的是空字符串不同：空字符串仍然是一个合法的 string。

保留空值语义：使用 sql.NullString

最直观的修复是让接收类型也能表达两种状态。Valid 为 true 表示确实读到了文本，false 表示数据库值为 NULL；这时 String 的零值不应被误当成原始数据。

var name sql.NullString

// Scan 同时接收文本和 NULL，避免把两种状态硬塞进 string。
if err := row.Scan(&name); err != nil {
    return fmt.Errorf("读取 name: %w", err) // 保留底层转换错误，便于排查
}

if name.Valid {
    fmt.Println("数据库文本:", name.String) // 只有 Valid 为 true 才使用 String
} else {
    fmt.Println("数据库值为 NULL") // 这里可以映射为接口层的缺省文案
}

如果项目使用支持泛型可空值的 Go 版本，也可以写成 sql.Null[string]，读取时使用 V 和 Valid。两种写法的关键都不是“把 NULL 变成某个字符串”，而是保留存在性信息。

var name sql.Null[string]

// 泛型 Null 保留字符串值与是否为 NULL 两个维度。
if err := row.Scan(&name); err != nil {
    return fmt.Errorf("读取 name: %w", err) // 让调用方知道 Scan 失败
}
display := "未填写"
if name.Valid {
    display = name.V // Valid 成立时才把 V 暴露给业务层
}

什么时候可以在 SQL 中使用 COALESCE

如果报表、搜索条件或展示接口的契约明确规定“NULL 就按空字符串处理”，可以把转换放到查询中：

SELECT COALESCE(name, '') AS name
-- 仅在业务确认 NULL 与空字符串等价时使用默认值
FROM users
WHERE id = ?;

这样 Scan 到 *string 就不再遇到 nil，但原始的 NULL 信息也已经丢失。更新、审计、补数和部分筛选逻辑往往需要区分“未填写”和“主动填写为空”，这些场景应继续使用可空目标，而不是为了消除报错统一 COALESCE。

按这张清单定位问题

相关问题

把 string 改成 *string 能解决吗？

不要把它当成通用修复。database/sql 的常规可空接收方式是实现了 Scanner 的类型，例如 sql.NullString；指针层级变化可能引入新的目标类型转换问题，先选择明确表达 Valid 的类型更可靠。

为什么 String 为空但 Valid 仍然重要？

NULL 被接收后通常也会留下字符串零值，但零值无法告诉你“原本就是空文本”还是“原本没有值”。判断必须看 Valid。

Scan 报错一定是数据库列定义的问题吗？

不一定。先检查实际返回值、查询中的表达式和每个 Scan 目标的类型；列允许 NULL、使用了左连接或表达式返回 NULL，都可能让普通字符串目标失败。