Go反射获取结构体字段地址方法

从现在开始，努力学习吧！本文《Go 反射获取结构体字段地址教程》主要讲解了等等相关知识点，我会在golang学习网中持续更新相关的系列文章，欢迎大家关注并积极留言建议。下面就先一起来看一下本篇正文内容吧，希望能帮到你！

本文详解如何通过反射动态获取结构体各字段的地址指针，生成符合 `sql.Rows.Scan` 要求的 `[]interface{}` 切片，并重点纠正常见误区：必须使用 `reflect.Value.Addr().Interface()` 而非 `.Pointer()`。

在 Go 中，database/sql.Rows.Scan 方法要求传入的每个参数都必须是指向变量的指针（如 &user.Name, &user.Age），而不能是原始值或 unsafe.Pointer。初学者常误以为 reflect.Value.Addr().Pointer() 返回的是可直接使用的“指针类型”，但实际上它返回的是一个 uintptr —— 即底层内存地址的整数表示，不是 Go 类型系统认可的指针值，因此无法满足 Scan 对 *interface{} 的类型要求，导致运行时 panic：

panic: sql: Scan error on column index 0: destination not a pointer

✅ 正确做法是调用 reflect.Value.Addr().Interface()：该方法将反射值安全地转换为对应类型的接口值（例如 *string 或 *int），这才是 Scan 所需的合法指针。

以下是修正后的完整工具函数及使用示例：

import "reflect"

type User struct {
    Name string
    Age  int
}

// StrutForScan 接收结构体变量的指针（如 &user），返回其所有字段地址的 []interface{}
func StructForScan(u interface{}) []interface{} {
    val := reflect.ValueOf(u)
    if val.Kind() != reflect.Ptr || val.IsNil() {
        panic("StructForScan: argument must be a non-nil pointer to a struct")
    }
    elem := val.Elem()
    if elem.Kind() != reflect.Struct {
        panic("StructForScan: pointed value must be a struct")
    }

    n := elem.NumField()
    result := make([]interface{}, n)
    for i := 0; i < n; i++ {
        field := elem.Field(i)
        // ✅ 关键：使用 Interface() 获取可被 Scan 接受的指针值
        result[i] = field.Addr().Interface()
    }
    return result
}

使用示例：

func ListUsers(db *sql.DB) {
    rows, err := db.Query("SELECT name, age FROM users") // 建议显式列名
    if err != nil {
        log.Fatal(err)
    }
    defer rows.Close()

    var user User
    for rows.Next() {
        // ✅ 正确展开：StructForScan(&user) 生成 []*string, *int 等
        err := rows.Scan(StructForScan(&user)...)
        if err != nil {
            log.Printf("Scan error: %v", err)
            continue
        }
        fmt.Printf("Name: %s, Age: %d\n", user.Name, user.Age)
    }
    if err = rows.Err(); err != nil {
        log.Fatal(err)
    }
}

⚠️ 注意事项：

• 必须传入结构体变量的地址（即 &user），否则 reflect.ValueOf(u).Elem() 会 panic；
• 字段必须是可寻址的（即不能是嵌入在只读上下文中的字段），且需导出（首字母大写），否则 Field(i) 返回不可寻址的 reflect.Value，调用 Addr() 会 panic；
• Scan 参数顺序必须与 SQL 查询字段顺序严格一致；建议在 SQL 中显式列出字段，避免因表结构变更引发静默错误；
• StructForScan 不处理嵌套结构体、切片或自定义 Scanner 接口——如需更健壮支持，请考虑 sqlx 或 gorm 等成熟库，但本实现是理解反射与 database/sql 协作机制的极佳学习范例。

掌握 Addr().Interface() 这一关键转换，你就打通了 Go 反射操作地址的核心链路：从值 → 可寻址反射值 → 地址反射值 → 安全指针接口值。这是构建通用 ORM 辅助工具的重要基石。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~