Go RowsColumnTypes 返回长度为 nil 时怎么解释

调用 Go 的 Rows.ColumnTypes() 后，有人会把返回结果包装成指针，再发现“长度是 nil”。先把结论说清楚：ColumnTypes() 返回的是 []*sql.ColumnType，真正读取长度要调用 ColumnType.Length()，它的签名是 (length int64, ok bool)，不是 *int64。看到 nil，通常是业务代码把 ok=false 转成了 nil，或者把结果集错误与列长度混在了一起。

处理列长度时只看 ok：具体变长类型得到有限的 int64，无界类型可能得到 math.MaxInt64，固定长度类型或驱动未提供能力则得到 ok=false。列值是否为 SQL NULL，要通过 Nullable() 或扫描结果另行判断。

先分清 ColumnTypes 和 Length 返回的两层结果

Rows.ColumnTypes() 负责拿到列的元数据集合。每个元素是一个 *sql.ColumnType，可以继续读取列名、数据库类型名、扫描类型、可空性和长度。长度并不是集合元素里的一个可直接比较的指针，而是方法调用后的二元结果。

// 先检查 ColumnTypes 的错误，再读取每一列的元数据
columnTypes, err := rows.ColumnTypes()
if err != nil {
    return fmt.Errorf("读取列元数据失败: %w", err)
}

for _, column := range columnTypes {
    length, lengthOK := column.Length()
    nullable, nullableOK := column.Nullable()
    fmt.Printf("name=%s type=%s length=%d lengthOK=%t nullable=%t nullableOK=%t\n",
        column.Name(), column.DatabaseTypeName(), length, lengthOK, nullable, nullableOK)
}

这里最重要的是保留两个布尔值。length 在 lengthOK=false 时没有业务含义；即使它恰好是 0，也不能据此断言列长度就是 0。nullableOK 也要单独判断，不能用它推导长度。

用 ok 判断长度是否真的可用

Go 的驱动接口把长度能力定义为 ColumnTypeLength(index int) (length int64, ok bool)。它只针对变长列类型；官方文档给出的语义是：类似 varchar(10) 的列可以返回 (10, true)，无界的 TEXT 可以返回 (math.MaxInt64, true)，而 decimal、int 这类不适用的类型返回 ok=false。

所以导出器或动态表格可以这样写：只有 lengthOK 为真时才显示“最大长度”；无界类型单独显示“未限定”，不可用时显示“驱动未提供”。不要把 length == 0 当作一个真实的数据库约束。

为什么看起来像 nil

第一种情况是业务包装。为了让 JSON 能表达“没有长度”，代码常把二元返回值改成 *int64。此时 nil 是包装层的表示，不是 database/sql 直接返回的值：

// 只有驱动明确提供长度时才创建指针
length, ok := column.Length()
var displayLength *int64
if ok {
    displayLength = &length
}
// displayLength == nil 只说明当前元数据不能作为有限长度使用
fmt.Printf("column=%s displayLength=%v\n", column.Name(), displayLength)

第二种情况是把结果集生命周期问题误认成列长度问题。ColumnTypes() 自身可能因 Rows 已关闭或内部没有可用结果集而返回错误；这时应该先处理 err，而不是继续把 nil 传给下游。第三种情况是驱动只提供了部分列元数据，类型名能读到，不代表长度、可空性和精度都一定能读到。

把列长度、NULL 和扫描结果分开处理

列类型长度回答“这个列的定义能否给出长度”；Nullable() 回答“驱动是否知道这个列允许 NULL”；而 Scan 处理的是某一行实际读到的值。三者不能互相替代。

// 元数据只决定展示策略，不决定某一行是否为 NULL
nullable, nullableOK := column.Nullable()
if nullableOK && nullable {
    fmt.Println("该列可能出现 SQL NULL")
}

for rows.Next() {
    var value any
    // 读取实际单元格；NULL 的判断在扫描后的 value 或 sql.Null* 类型上完成
    if err := rows.Scan(&value); err != nil {
        return fmt.Errorf("扫描数据失败: %w", err)
    }
}
if err := rows.Err(); err != nil {
    return fmt.Errorf("遍历结果集失败: %w", err)
}

如果业务要把列元数据输出给前端，建议把状态显式编码成“有限长度、无界、未知”三种状态；如果业务要保存行值，则根据实际字段类型选择 sql.NullString、sql.NullInt64 或自定义 Scanner。这样就不会因为元数据的 ok=false 而错误地把一行 NULL 当成空字符串或长度为 0。

给导出和表格逻辑加安全兜底

元数据经常被用于自动生成表头、CSV 字段说明或接口文档。一个稳妥的判断顺序是：先检查 ColumnTypes() 的错误，再检查 Length() 的 ok，最后才根据类型名和业务配置决定展示方式。长度不可用时继续导出数据通常是合理的，但不要据此做截断、缓冲区分配或数据库约束推断。

1. 长度有限且 ok=true：展示具体值，必要时做提示性校验。
2. 长度无界且 ok=true：展示“未限定”，不要把 math.MaxInt64 变成前端输入框上限。
3. ok=false：记录类型名和驱动信息，使用业务默认列宽或省略长度字段。
4. 读取实际数据：单独处理 NULL，并在循环后检查 rows.Err()。

常见问题

Length 返回 0、false，是不是数据库长度为 0？

不是。它通常表示该类型不适用长度概念，或驱动没有提供长度元数据。必须先看第二个返回值。

TEXT 返回 math.MaxInt64，要按这个值申请内存吗？

不要。它表达的是没有额外的类型长度上限，实际数据库限制、单行大小和应用资源仍然存在。

Nullable 返回 false、false，能说明列不允许 NULL 吗？

不能。第二个 false 表示驱动无法确认可空性；只有 nullableOK=true 时，第一个值才有判断意义。

参考资料

Go database/sql 包文档、Go 标准库 database/sql 源码、Go database/sql/driver 元数据接口源码。