本文详解如何通过反射配合 sqlx.Rows.StructScan，将查询结果安全、高效地扫描到任意结构体切片指针中，解决 StructScan 无法直接接收 *reflect.Value 的常见类型错误。
本文详解如何通过反射配合 sqlx.rows.structscan，将查询结果安全、高效地扫描到任意结构体切片指针中，解决 `structscan` 无法直接接收 `*reflect.value` 的常见类型错误。
在使用 sqlx 进行数据库操作时，Rows.StructScan 是一个强大且常用的方法，它能将单行查询结果自动映射到 Go 结构体字段（支持 db 标签）。但当需要封装通用数据获取函数（如 GetData(sql string, dest interface{})）并支持任意结构体切片时，直接使用反射创建实例并传入 StructScan 容易因类型不匹配而失败——典型错误是误将 *reflect.Value（如 &myData）传给期望 interface{}（即具体结构体指针）的 StructScan。
根本原因在于：StructScan 要求传入的是 指向目标结构体实例的指针（例如 &Data{}），而非 *reflect.Value。而 reflect.New() 返回的是 reflect.Value 类型，其地址需通过 .Interface() 显式转换为 interface{} 才符合签名要求。
以下是经过验证的正确实现方式：
import (
"reflect"
"log"
"github.com/jmoiron/sqlx"
)
func GetData(sql string, dest interface{}) error {
// 1. 确保 dest 是指向切片的指针，如 *[]Data
destVal := reflect.ValueOf(dest)
if destVal.Kind() != reflect.Ptr || destVal.Elem().Kind() != reflect.Slice {
return fmt.Errorf("dest must be a pointer to slice")
}
slice := destVal.Elem() // 获取切片本身（如 []Data）
elemType := slice.Type().Elem() // 获取切片元素类型（如 Data）
rows, err := DBI.Queryx(sql)
if err != nil {
return err
}
defer rows.Close()
// 2. 为每一行创建新结构体实例
for rows.Next() {
instance := reflect.New(elemType) // 返回 reflect.Value，代表 *Data
if err := rows.StructScan(instance.Interface()); err != nil {
return err
}
// 3. 将解包后的值（instance.Elem()）追加到切片
slice = reflect.Append(slice, instance.Elem())
}
// 4. 将修改后的切片写回原始 dest
destVal.Elem().Set(slice)
return rows.Err()
}✅ 关键要点说明：
- instance.Interface() 将 reflect.Value 转为 interface{}，满足 StructScan 参数要求；
- instance.Elem() 获取结构体值（非指针），用于 reflect.Append；
- 必须调用 destVal.Elem().Set(slice) 将新构建的切片写回调用方变量；
- 建议添加 defer rows.Close() 和 rows.Err() 检查，确保资源释放与错误传播；
- 生产环境应校验 dest 类型（如是否为 *[]T），避免 panic。
? 调用示例：
type Data struct {
ID int `db:"id"`
Caption string `db:"caption"`
}
func Func1() {
var data []Data
err := GetData("SELECT id, caption FROM items", &data)
if err != nil {
log.Fatal(err)
}
log.Printf("Fetched %d records: %+v", len(data), data)
}⚠️ 注意事项：
- 结构体字段必须为导出字段（首字母大写），否则反射无法访问；
- db 标签名需与 SQL 列名严格匹配（大小写敏感，取决于数据库配置）；
- 若 SQL 查询列数/类型与结构体不匹配，StructScan 会返回明确错误，应始终检查；
- 高并发场景下，建议复用 sqlx.DB 实例并启用连接池，避免性能瓶颈。
掌握这一模式后，你可轻松构建类型安全、零重复的通用数据加载层，显著提升 DAO 层的可维护性与扩展性。
