Go database/sql.ColumnTypes 怎么导出查询结果的列名和可空信息

如果要把动态 SQL 的结果列导出成表格或 JSON，优先从 Rows.ColumnTypes() 取得元数据。每个 *sql.ColumnType 可以用 Name() 读取列名或别名，用 DatabaseTypeName() 读取数据库类型名，再用 Nullable() 判断列是否允许 NULL。关键是不要把 Nullable 返回的 ok=false 当成“不可空”：它表示当前驱动没有提供这项信息。

官方文档：https://pkg.go.dev/database/sql#Rows.ColumnTypes

导出列结构时，把“可空值”和“驱动是否支持可空信息”分成两个字段；类型名为空也应保留为空，而不是猜测数据库类型。

先用 ColumnTypes 拿到稳定的列元数据

ColumnTypes 返回列类型切片和错误。它的调用对象是已经执行查询得到的 *sql.Rows，不是 *sql.DB。列的顺序与查询结果列顺序一致，因此可以直接按下标生成导出描述。官方文档也提醒，部分信息可能因驱动而不可用。

type ColumnMeta struct {
	Name         string `json:"name"`
	DatabaseType string `json:"database_type"`
	Nullable     bool   `json:"nullable"`
	NullableOK   bool   `json:"nullable_supported"`
}

func readColumnMeta(rows *sql.Rows) ([]ColumnMeta, error) {
	// ColumnTypes 失败时不能继续猜列结构，直接把驱动错误交给调用方。
	types, err := rows.ColumnTypes()
	if err != nil {
		return nil, fmt.Errorf("读取查询列元数据失败: %w", err)
	}

	meta := make([]ColumnMeta, 0, len(types))
	for _, column := range types {
		// Nullable 的第二个返回值表示驱动是否支持该属性。
		nullable, nullableOK := column.Nullable()
		meta = append(meta, ColumnMeta{
			Name:         column.Name(),
			DatabaseType: column.DatabaseTypeName(),
			Nullable:     nullable,
			NullableOK:   nullableOK,
		})
	}
	return meta, nil
}

这个函数只读取列结构，不读取行数据，也不负责关闭 rows。查询生命周期仍由创建查询结果的代码管理；如果还要遍历数据，应继续使用 Next、Scan 和 Err。

Name 和 DatabaseTypeName 要分别保存

Name() 返回列名或别名，适合成为导出字段的键。DatabaseTypeName() 返回数据库系统的类型名，例如 VARCHAR、TEXT、INT 或 BIGINT；它不包含长度修饰符。如果驱动不支持类型名，返回值可能是空字符串。

因此，下面三种信息不要混成一个字符串：

• 列名：用户看到的结果列标识，可能是 SQL 别名。
• 数据库类型：驱动报告的系统类型名，不等于 Go 扫描类型。
• 可空能力：数据库列是否可能为 NULL，还要看驱动是否支持报告。

如果导出协议要求类型名非空，应在协议层把空字符串标记为“未知”，不要从列名或扫描类型反推。这样既不会误导下游，也能区分驱动能力不足和真正的字段类型。

Nullable 必须同时判断两个返回值

Nullable() 的签名是 (nullable, ok bool)。只有 ok=true 时，nullable 才有明确含义：true 表示可能为 NULL，false 表示驱动报告为不可空。当 ok=false 时，nullable 不能作为可靠结论，导出时应保留“未知”。

这和扫描时是否使用 sql.NullString、sql.Null[T] 是两层问题：元数据描述列的能力，扫描目标负责接收某一行的实际值。不要因为元数据未知，就擅自把所有字段改成可空；也不要因为一次查询没有出现 NULL，就推断列永远不可空。

排查导出结果不对时的检查清单

1. 确认调用的是当前查询返回的 rows，而不是另一个结果集。
2. 先处理 ColumnTypes 错误，再遍历切片。
3. 对每个字段同时记录 Name、DatabaseTypeName、nullable 和 nullableOK。
4. 类型名为空或 nullableOK=false 时保留未知状态，不用经验值填补。
5. 如果还要导出数据，再单独处理 Next、Scan 和 rows.Err()。

这样生成的列模式既能服务于动态表格，也能作为数据导出协议的说明。它的边界很清楚：ColumnTypes 告诉你驱动愿意报告的结果列信息，不替代 ORM 模型生成，也不保证所有数据库驱动都能提供完整模式。

常见问题

为什么 Nullable 返回 false 还要看 ok？

因为 false 可能只是零值；当 ok=false 时，驱动没有承诺这个属性，正确做法是输出未知。

DatabaseTypeName 为空能否用 ScanType 替代？

不能直接替代。DatabaseTypeName 是数据库系统类型名，ScanType 是适合传给 Rows.Scan 的 Go 类型，两者服务于不同的描述层。