Go语言中使用反射动态构建结构体数组处理SQL查询结果-Golang-PHP中文网

本文介绍如何利用go反射机制，根据传入的结构体类型模板动态创建实例并扫描sql查询结果，避免硬编码具体结构体类型，实现通用化的数据库行数据映射。

本文介绍如何利用go反射机制，根据传入的结构体类型模板动态创建实例并扫描sql查询结果，避免硬编码具体结构体类型，实现通用化的数据库行数据映射。

在Go开发中，常需将SQL查询结果映射为结构体切片（如 []User），但若希望封装一个泛型化、类型无关的工具函数（尤其在API层需动态响应不同表结构时），直接传入结构体实例或类型名往往不够灵活。此时，reflect 包成为关键——它允许我们在运行时动态创建结构体实例、获取字段地址并完成 sql.Rows.Scan。

以下是一个完整、可落地的解决方案：

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

✅ 核心思路

接收任意结构体类型的零值接口（如 User{}）作为类型模板；
使用 reflect.TypeOf(u) 获取其类型，再通过 reflect.New(t) 创建该类型的指针实例；
调用辅助函数 StructForScan() 将该指针转换为 []interface{}，供 rows.Scan() 使用；
扫描成功后，将解引用后的值（即结构体实例本身）追加到结果切片中。

✅ 完整可运行代码示例

package main

import (
    "database/sql"
    "encoding/json"
    "fmt"
    "reflect"
)

type User struct {
    IdUser   int    `json:"id_user"`
    Name     string `json:"name"`
    Email    string `json:"email"`
    Username string `json:"username"`
}

// StructForScan 返回结构体字段地址切片，用于 rows.Scan
func StructForScan(u interface{}) []interface{} {
    val := reflect.ValueOf(u).Elem() // u 必须是指针，.Elem() 获取实际结构体值
    fields := make([]interface{}, val.NumField())
    for i := 0; i <h3>⚠️ 关键注意事项</h3>

传参必须是结构体零值（非指针）：如 User{} 或 user 变量，而非 &User{} —— 否则 reflect.TypeOf 会得到 *User，需额外 .Elem() 处理；
字段必须可寻址（exported）：所有待扫描字段需首字母大写（IdUser 而非 id_user），否则 field.Addr() 会 panic；
标签不影响扫描逻辑：json 标签仅用于序列化，sql.Scan 依赖字段顺序与 SELECT 列顺序严格一致；
错误处理不可省略：示例中使用 panic 仅为演示，生产代码应返回 ([]interface{}, error) 并妥善处理 rows.Err() 和 rows.Scan() 错误；
性能考量：反射有开销，高频场景建议预编译 Scanner 或使用 sqlx 等成熟库替代。

通过此方法，你只需维护一个结构体定义，即可复用 StructRow 处理任意表查询，真正实现「一次编写，多处映射」的动态数据绑定能力。