Go 中使用反射获取结构体字段地址并正确传递给 rows.Scan 的完整教程

本文详解如何通过反射动态获取结构体各字段的地址指针，生成符合 `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: %dn", 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 辅助工具的重要基石。