Go 中优雅处理 SQL NULL 值的实践指南-Golang-PHP中文网

本文介绍一种简洁、类型安全且无需修改数据库或冗余 sql 的 go 语言方案：使用指针字段配合 database/sql 扫描，自动兼容 null，并原生支持 json 序列化输出。

本文介绍一种简洁、类型安全且无需修改数据库或冗余 sql 的 go 语言方案：使用指针字段配合 database/sql 扫描，自动兼容 null，并原生支持 json 序列化输出。

在构建面向遗留数据库的 Go API 时，SQL NULL 值常成为开发者的痛点——Go 的标准 sql.Scan 无法将 NULL 直接映射到基础类型（如 string、int），而强制使用 sql.NullString 等类型又导致结构体臃肿、重复判断、JSON 输出不自然。幸运的是，一个被低估但高度实用的解决方案早已内置于 Go 标准库中：使用指向基础类型的指针作为扫描目标。

该方案的核心原理在于：database/sql 对 *string、*int、*float64、*bool 等指针类型具有原生 NULL 感知能力。当数据库字段为 NULL 时，扫描会将对应指针置为 nil；当值存在时，则分配内存并写入解码后的值。更重要的是，Go 的 json 包对 nil 指针的序列化行为天然符合 REST API 需求：*string 为 nil → JSON 中输出 null；非 nil → 输出字符串字面量。

以下是一个完整可运行的示例：

Go语言（Golang）Linux版

Go语言（Golang）Linux版适合在 Linux 环境中部署 Go 编译工具链，支持服务端开发、微服务、网络程序、容器化项目和自动化工具开发。

下载

func queryFamilyRecords(db *sql.DB, surname string) ([]byte, error) {
    rows, err := db.Query(
        "SELECT mothername, fathername, surname FROM fams WHERE surname = ?",
        surname,
    )
    if err != nil {
        return nil, fmt.Errorf("query failed: %w", err)
    }
    defer rows.Close()

    // 使用指针字段定义结构体 —— 关键设计
    type record struct {
        Mname   *string `json:"mothername"`
        Fname   *string `json:"fathername"`
        Surname *string `json:"surname"`
    }

    var records []record
    for rows.Next() {
        var r record
        // 注意：直接传入 r.Mname 等（已是 *string），无需 &r.Mname
        if err := rows.Scan(&r.Mname, &r.Fname, &r.Surname); err != nil {
            return nil, fmt.Errorf("scan failed: %w", err)
        }
        records = append(records, r)
    }
    if err := rows.Err(); err != nil {
        return nil, fmt.Errorf("rows iteration error: %w", err)
    }

    return json.Marshal(records)
}

// 调用示例
data, err := queryFamilyRecords(db, "Nullfather")
if err != nil {
    log.Fatal(err)
}
fmt.Println(string(data))
// 输出：[{"mothername":"Mary","fathername":null,"surname":"Nullfather"}]

✅ 优势总结：