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










