Go ColumnType.DatabaseTypeName 返回空时怎么兼容驱动差异

用 Go 的 database/sql 做通用表格导出或字段映射时，ColumnType.DatabaseTypeName() 偶尔会返回空字符串。这个结果不代表 SQL 执行失败，也不表示列没有类型；它只说明当前驱动没有提供数据库类型名。兼容做法是保留列名和 ScanType() 等可用信息，把类型名标记为未知，必要时再使用应用自己的显式映射，而不是把空值硬猜成某个数据库类型。

先把空字符串当成能力缺失处理

官方文档对该方法的语义很明确：返回空字符串时，驱动不支持提供 driver type name；常见返回值可能是 VARCHAR、TEXT、DECIMAL、INT 等，而且长度规格不包含在类型名里。因此，下面两种情况必须分开：

读取列元数据时不要只保存类型名

通用代码通常同时需要列名、数据库类型名和可用于 Rows.Scan 的 Go 类型。Nullable()、Length()、DecimalSize() 还可能通过返回值中的 ok 表示驱动是否支持对应属性。把这些结果收集到自己的结构体里，后续导出器就不必依赖某一个驱动的完整实现。

// ColumnMeta 只保存当前驱动实际提供的能力，不伪造缺失类型。
type ColumnMeta struct {
	Name      string
	DBType    string
	ScanType  string
	LengthOK  bool
	DecimalOK bool
}

func readColumns(rows *sql.Rows) ([]ColumnMeta, error) {
	// ColumnTypes 失败是元数据查询错误，不能和空类型名混为一谈。
	types, err := rows.ColumnTypes()
	if err != nil {
		return nil, fmt.Errorf("read column types: %w", err)
	}

	result := make([]ColumnMeta, 0, len(types))
	for _, column := range types {
		meta := ColumnMeta{
			Name:     column.Name(),
			DBType:   column.DatabaseTypeName(),
			ScanType: column.ScanType().String(),
		}
		// 空 DBType 保留为空，后面统一交给兼容回退函数处理。
		if _, _, ok := column.DecimalSize(); ok {
			meta.DecimalOK = true
		}
		if _, ok := column.Length(); ok {
			meta.LengthOK = true
		}
		result = append(result, meta)
	}
	return result, nil
}

这个结构把“没有类型名”和“没有长度信息”分别记录。不要因为 ScanType() 返回了 interface {} 就反过来推断数据库列一定是通用文本；它只能说明扫描目标信息有限。

用有序回退兼容不同驱动

回退的关键是可解释。优先使用驱动返回的非空类型名；如果业务确实知道某个查询列的语义，再使用查询级显式映射；只有在没有映射时，才把 Go 扫描类型作为提示，最终统一落到 unknown。这样既能支持导出，又不会把推测写回数据库定义。

// displayType 生成给导出器使用的展示类型，unknown 表示信息不足。
func displayType(meta ColumnMeta, explicit map[string]string) string {
	if meta.DBType != "" {
		return meta.DBType
	}
	if mapped := explicit[meta.Name]; mapped != "" {
		// 显式映射必须由调用方维护，避免把 Go 类型冒充数据库类型。
		return mapped
	}
	if meta.ScanType != "" && meta.ScanType != "interface {}" {
		return "go:" + meta.ScanType
	}
	return "unknown"
}

显式映射应绑定到具体查询或数据源，而不是做成全局的“列名猜类型”规则。不同表可能都有 id、value 这样的名字，跨表复用会制造更隐蔽的误判。

把驱动差异放进测试矩阵

不要只用一个驱动跑通就结束。最小测试矩阵至少覆盖：返回非空类型名、返回空类型名、长度或精度能力不可用，以及 ColumnTypes() 本身失败。对空值分支的断言应是“导出仍有列名，展示类型为显式映射或 unknown”，而不是断言某个驱动必须返回 VARCHAR。

常见问题

DatabaseTypeName 返回空，能否直接按 VARCHAR 处理？

不能。空字符串只说明驱动没有提供类型名，无法证明数据库列是字符串。只有查询契约或调用方掌握可靠语义时，才使用显式映射。

ScanType 能不能替代 DatabaseTypeName？

不能完全替代。ScanType 描述适合传给 Rows.Scan 的 Go 类型，DatabaseTypeName 描述数据库系统类型；两者用途不同，最多把 ScanType 作为展示提示。

类型名为空时还要继续导出吗？

如果导出只需要列名和可扫描值，通常可以继续；如果下游必须依赖数据库类型做精确 DDL 生成，就应要求数据源提供显式 schema 或驱动级补充能力，而不是静默猜测。

最终可以把判断压缩成一句话：DatabaseTypeName()=="" 是兼容性分支，ColumnTypes() 的 error 才是元数据读取失败。先保留事实，再按调用场景选择显式映射或 unknown，跨驱动行为就会稳定得多。