Go database/sql ColumnType.DatabaseTypeName 怎么读取驱动返回的 SQL 类型

用 Go 查询一张结构不固定的表时，我更常先看结果集的元数据，再决定如何展示或映射字段。这个场景里，ColumnType.DatabaseTypeName() 的职责很窄：它返回驱动提供的数据库类型名，不负责读取字段值，也不保证所有驱动都能给出非空结果。

最短用法是先调用 rows.ColumnTypes()，再逐个调用 DatabaseTypeName()。官方资料：https://pkg.go.dev/database/sql#ColumnType.DatabaseTypeName。如果返回空字符串，应优先检查驱动是否实现了可选的列类型元数据接口，而不是马上把它当成 VARCHAR 或把查询结果判定为异常。

记住一条排查主线：ColumnTypes 负责拿列元数据，DatabaseTypeName 负责读驱动返回的 SQL 类型名；空字符串表示这项类型名不受当前驱动支持，不能凭空推断具体数据库类型。

先确认类型信息从 Rows.ColumnTypes 进入

ColumnType 不是从 Scan 目标变量推导出来的，而是结果集提供的列描述。Rows.ColumnTypes() 返回一个与结果集列对应的切片；每个元素都能分别读取列名、数据库类型名、建议的 Go 扫描类型、长度和可空性等信息。查询已经失败、Rows 已关闭或驱动没有结果集时，首先要处理 ColumnTypes 自己返回的错误。

实际排查时可以把“列名”和“类型名”并排记录。例如列名可能是查询别名，而 DatabaseTypeName 更接近驱动报告的数据库系统类型。两者用途不同，不能用列名是否为空来判断类型元数据是否存在。

DatabaseTypeName 只读取驱动报告的类型名

拿到 *sql.ColumnType 后，直接调用 DatabaseTypeName() 即可：

for i, column := range columns {
    // Name 是结果集中的列名或别名，类型名是另一项元数据。
    fmt.Printf("%d: name=%s database_type=%s\n", i, column.Name(), column.DatabaseTypeName())
}

返回值通常是类似 VARCHAR、TEXT、DECIMAL、INT 或 BIGINT 的类型名。官方文档明确说明，ColumnType.Length 的规格不会附加到这个字符串上，所以不要期待得到 VARCHAR(255) 这样的完整声明；长度应单独调用 Length()。

驱动接口文档还建议类型名使用大写，并列举了 VARCHAR2、JSONB、XML、TIMESTAMP 等示例。不过这仍然是驱动报告的名字，不是 database/sql 统一生成的跨数据库枚举。需要跨数据库比较时，应先定义自己的映射策略，而不是直接比较所有字符串。

返回空字符串时，沿驱动支持链排查

DatabaseTypeName() 返回空字符串，官方语义是驱动类型名不受支持。database/sql 会在内部检查底层 Rows 是否实现 driver.RowsColumnTypeDatabaseTypeName；实现了才填充数据库类型名，没有实现就保留空字符串。这是一个可选能力，不代表字段值为空，也不代表 SQL 查询没有列。

因此可以按下面的顺序判断：

• ColumnTypes 返回错误：先处理 Rows 生命周期、查询错误或驱动返回错误。
• ColumnType 存在但类型名为空：按“驱动未提供该元数据”处理，查所用驱动的文档，而不是硬编码默认类型。
• 类型名有值但格式不同：把它当成驱动约定，保留原值并在应用层做显式归一化。

用一份清单同时读取相关元数据

下面示例只展示元数据读取路径，不连接特定数据库，也不把示例输出冒充成某个驱动的真实结果。它保留了查询错误、关闭资源和迭代错误的处理位置：

func describeRows(rows *sql.Rows) error {
    defer rows.Close() // 无论元数据或迭代哪一步失败，都释放结果集。

    columns, err := rows.ColumnTypes()
    if err != nil {
        return fmt.Errorf("读取列元数据失败: %w", err)
    }
    for i, column := range columns {
        scanType := column.ScanType()
        length, hasLength := column.Length()
        nullable, hasNullable := column.Nullable()

        // 类型名为空是驱动能力边界，不把它改写成猜测的数据库类型。
        fmt.Printf("列%d name=%q dbType=%q scanType=%v\n", i,
            column.Name(), column.DatabaseTypeName(), scanType)
        if hasLength {
            fmt.Printf("  length=%d\n", length)
        }
        if hasNullable {
            fmt.Printf("  nullable=%t\n", nullable)
        }
    }

    for rows.Next() {
        // 本文只读取列描述；真实业务在这里按列数准备 Scan 目标。
    }
    if err := rows.Err(); err != nil {
        return fmt.Errorf("遍历结果集失败: %w", err)
    }
    return nil
}

这份代码故意把几个容易混淆的字段放在一起：DatabaseTypeName 是数据库类型名，ScanType 是适合传给 Rows.Scan 的 Go 类型，Length 和 Nullable 还各自带有 ok 标志。某一项不支持时，应根据对应的 ok 或空值语义分别处理。

常见误区与最后的排查清单

我在这类问题上最后会检查四点：ColumnTypes 的错误是否处理、每个 ColumnType 是否按索引对应、空字符串是否保留驱动能力边界、以及元数据读取是否和字段值扫描分开。这样既能回答“驱动返回了什么 SQL 类型”，也不会把 database/sql 的可选信息误包装成所有数据库都一致的事实。

相关问题

DatabaseTypeName 能直接判断 Go 变量类型吗？不能。它是驱动报告的数据库系统类型名；需要准备 Scan 目标时，还要结合 ScanType()、NULL 处理和实际驱动行为。

为什么 Length 和类型名要分开读？因为官方 API 将类型名与长度规格设计成不同元数据。类型名不包含 Length() 的规格，长度是否可用也由驱动单独报告。

没有类型名时能不能默认按字符串处理？只能由应用明确选择兜底策略，不能说 database/sql 已经把该列定义为字符串。默认策略应记录在自己的映射代码和文档中。