Go database/sql.ColumnType.Nullable 怎样判断列是否允许 NULL

用 Go 的 database/sql 读取查询结果元数据时，可以先调用 Rows.ColumnTypes，再对每个 ColumnType 调用 Nullable。它返回“可空值”和“是否知道这个结果”的两个布尔值：第一个值是列是否允许 NULL，第二个值表示驱动是否提供了可靠信息。最容易出错的地方是把第二个 false 忽略，直接把第一个 false 当成“明确 NOT NULL”。

判断列是否允许 NULL 时，先看 Nullable() 的第二个返回值；只有它为 true 时，第一个返回值才适合参与业务判断。第二个返回值为 false 时，应把结果当作未知，而不是当作不可空。

先看 Nullable 的返回值

ColumnType.Nullable 的签名是 (nullable, ok bool)。nullable 表示列能否为 NULL，ok 表示驱动是否知道这个答案。三种结果可以这样理解：

这里的 ok 不是“调用成功”的意思，而是“元数据是否可用”。如果应用要动态生成表单、导入模板或扫描目标类型，应先处理未知状态。

用 ColumnTypes 读取列可空性

调用顺序是：执行查询、延迟关闭 Rows、读取列类型、逐列调用 Nullable。下面的示例只演示元数据决策，不依赖具体数据库驱动。

package main

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

// printNullability 把可空、不可空和未知三种结果分开输出。
func printNullability(ctx context.Context, db *sql.DB, query string) error {
    // QueryContext 让查询遵守调用方的取消和超时边界。
    rows, err := db.QueryContext(ctx, query)
    if err != nil {
        return fmt.Errorf("查询失败: %w", err)
    }
    // Rows 持有连接和驱动资源，返回前必须关闭。
    defer rows.Close()

    types, err := rows.ColumnTypes()
    if err != nil {
        return fmt.Errorf("读取列元数据失败: %w", err)
    }
    for _, column := range types {
        // ok 为 false 时，nullable 的真假都不能当成确定结论。
        nullable, ok := column.Nullable()
        switch {
        case !ok:
            fmt.Printf("%s: 未知\\n", column.Name())
        case nullable:
            fmt.Printf("%s: 允许 NULL\\n", column.Name())
        default:
            fmt.Printf("%s: 不允许 NULL\\n", column.Name())
        }
    }
    return rows.Err()
}

示例最后仍然调用 rows.Err()，因为列元数据读取成功不代表后续遍历或驱动交互没有错误。元数据用于描述结果集，不替代真正的行扫描。

遇到驱动不支持时怎样处理

不同驱动提供的列元数据能力可能不完全一致。ok == false 时，推荐让上层看到“未知”状态：动态表单可以保守地要求输入或交给数据库返回错误，代码生成器可以使用可配置默认值，数据导入器则应记录列名并继续处理其它列。

不要这样写：

// 错误示例：忽略 ok 会把“未知”误判成“不允许 NULL”。
nullable, _ := column.Nullable()
if !nullable {
    rejectNullValue(column.Name())
}

更稳妥的做法是显式携带状态：

// Nullability 用 Known 区分“确定答案”和“驱动未知”。
type Nullability struct {
    Nullable bool
    Known    bool
}

// readNullability 保留 Nullable 的两个返回值，避免信息丢失。
func readNullability(column *sql.ColumnType) Nullability {
    nullable, ok := column.Nullable()
    return Nullability{Nullable: nullable, Known: ok}
}

不要把可空性当成扫描保证

Nullable 描述的是列元数据，不会替你完成 Scan 的目标类型设计。数据库表达式、聚合结果和驱动转换规则都可能影响最终值。即使元数据显示不可空，扫描时仍要正确处理类型转换错误；如果元数据显示可空，应考虑 sql.NullString、sql.NullInt64 或驱动支持的可空类型。

可以用下面的清单收尾：

• 先读取 Rows.ColumnTypes，再调用每列的 Nullable。
• 只有 ok == true 时才解释 nullable。
• 未知状态不能等同于 NOT NULL。
• 元数据判断与 Scan 错误处理分开。

常见问题

Nullable 返回 false 就一定不能写入 NULL 吗？ 不一定。必须同时确认第二个返回值为 true；否则它可能只是驱动没有提供答案。

ColumnTypes 能代替查询表结构吗？ 不能。它描述当前查询结果集，表达式、别名和聚合列不一定等同于底层表字段。