Go database/sql 怎么读取查询结果的列类型信息

如果查询字段来自动态 SQL、视图或用户自定义的 SELECT，代码往往不能提前写死每一列的数据库类型。Go 不需要直接依赖某个数据库客户端：拿到 *sql.Rows 后调用 ColumnTypes()，就能读取列名、数据库类型名、长度、精度、可空性和建议扫描类型。

入口是 rows.ColumnTypes()，结果是 []*sql.ColumnType。但每个字段都可能受驱动能力影响，Nullable() 描述的是“列是否可能为 NULL”，不是当前行的值；真正扫描数据时，仍要用 sql.NullString、sql.NullInt64 或 any 处理 NULL。

读取列类型信息，先把三个概念分开

列类型元数据来自结果集，而不是来自 *sql.DB 的连接对象。查询成功后先取 ColumnTypes，再按列遍历；只想打印元数据时可以直接结束并关闭 Rows，还要读取数据时则继续调用 Next 和 Scan。

func printColumnMeta(rows *sql.Rows) error {
    defer rows.Close() // 释放结果集，避免连接长期被占用

    columns, err := rows.ColumnTypes()
    if err != nil {
        return fmt.Errorf("读取列元数据失败: %w", err)
    }

    for _, column := range columns {
        nullable, nullableOK := column.Nullable()
        length, lengthOK := column.Length()
        precision, scale, decimalOK := column.DecimalSize()
        scanType := column.ScanType()

        fmt.Printf("name=%s dbType=%s scanType=%s nullable=%t/%t length=%d/%t decimal=%d,%d/%t\n",
            column.Name(), column.DatabaseTypeName(), scanType.String(),
            nullable, nullableOK, length, lengthOK, precision, scale, decimalOK)
    }
    return rows.Err() // 统一返回迭代阶段留下的错误
}

这里的三个核心字段职责不同：Name() 适合做输出键，可能是 SQL 别名；DatabaseTypeName() 返回驱动提供的数据库类型名，通常不包含长度；ScanType() 返回适合传给 Rows.Scan 的 Go 类型。一个列完全可能叫 total、数据库类型是 DECIMAL，建议扫描类型却是某个驱动映射的数值类型。

Length 和 DecimalSize 的 ok 才是可用性信号

Length() 主要用于可变长度的文本或二进制列；固定长度或驱动不支持时，ok 可能是 false。没有上限的类型可能返回 math.MaxInt64，这不能被当成业务允许的实际长度。

DecimalSize() 给出 decimal 的 precision 和 scale，同样要看 ok。因此，元数据展示可以这样组织：

特别是 Length 返回的数值没有 ok 时不能单独解释；跨 MySQL、PostgreSQL、SQLite 等驱动做通用工具时，应把“驱动未提供”显示为未知，而不是擅自补成默认值。

Nullable 只说“可能为空”，不替代实际 Scan

Nullable() 是列级元数据：返回 true, true 表示驱动知道该列可能为空，返回 false, true 表示已知不可为空，返回任意值但 ok=false 表示驱动无法确认。它不检查当前行，更不会把 SQL NULL 自动转换成空字符串或 0。

扫描单个可空字段时，使用实现了 sql.Scanner 的类型更清楚：

var label sql.NullString
if err := row.Scan(&label); err != nil {
    return fmt.Errorf("扫描 label 失败: %w", err)
}
if label.Valid {
    fmt.Println("实际文本:", label.String)
} else {
    fmt.Println("当前行的 label 是 NULL")
}

因此，元数据检查适合决定“界面怎么展示列、接收器如何规划”，实际扫描仍以当前行返回的值为准。需要同时兼容多种驱动时，不能仅凭 ScanType() 就把可空列强制扫描进普通 string 或 int64。

未知列数时怎么动态接收查询结果

如果工具要导出任意 SELECT 的结果，先用 Columns() 得到列名，再创建同样长度的 []any。每个元素放一个指向接口变量的指针，Scan 后既能保留驱动返回的真实值，也能用 nil 识别 SQL NULL：

func scanUnknownColumns(rows *sql.Rows) ([]map[string]any, error) {
    defer rows.Close() // 结果集只在本次导出期间使用

    names, err := rows.Columns()
    if err != nil {
        return nil, fmt.Errorf("读取列名失败: %w", err)
    }

    values := make([]any, len(names))
    dest := make([]any, len(names))
    for i := range values {
        dest[i] = &values[i] // Scan 需要可写的接收地址
    }

    var result []map[string]any
    for rows.Next() {
        if err := rows.Scan(dest...); err != nil {
            return nil, fmt.Errorf("动态扫描失败: %w", err)
        }
        record := make(map[string]any, len(names))
        for i, name := range names {
            record[name] = values[i] // nil 表示该行该列为 NULL
        }
        result = append(result, record)
    }
    if err := rows.Err(); err != nil {
        return nil, fmt.Errorf("遍历结果集失败: %w", err)
    }
    return result, nil
}

这段接收方式适合通用导出器、调试工具和动态报表；如果业务字段已知，仍建议直接扫描到明确类型或 sql.Null* 类型。动态工具还要注意列名重复：如果 SQL 没有别名，映射到 map 时后一个同名列会覆盖前一个，必要时应改用带序号的字段结构。

常见问题

ColumnTypes 和 Columns 有什么区别？

Columns() 只返回列名；ColumnTypes() 返回 *sql.ColumnType，可继续读取类型、长度和可空性等元数据。

Nullable 返回 false 就代表当前值不是 NULL 吗？

不代表。只有在 ok=true 时，false 才表示驱动确认列不可空；当前行仍应以 Scan 的实际结果判断。

为什么 DatabaseTypeName 可能是空字符串？

列类型名由数据库驱动提供；驱动不支持或无法映射时，标准库会返回空字符串，通用程序应保留“未知”状态。

ScanType 能不能直接拿来创建扫描变量？

可以作为建议，但不是可空性保证。遇到可能为 NULL 的字段，用 sql.Null* 或 any 更稳妥。

官方资料

• Go database/sql 包文档：查看 Rows.ColumnTypes 和 ColumnType 方法说明。
• Go database/sql/driver 包文档：了解驱动提供列类型、长度、可空性和扫描类型的接口。
• Go 数据库访问指南：了解 database/sql 与具体驱动的职责边界。