Golang反射实现简单工厂模式示例

用 reflect 实现工厂易 panic,因 New 或 Call 会直接崩溃于未导出类型、参数不匹配或字段不可设;需确保类型导出、构造函数签名统一、结构体实现同一接口。

为什么用 reflect 实现工厂容易出 panic

直接调用 reflect.Newreflect.Value.Call 时,如果传入的类型没导出、构造函数参数不匹配、或目标结构体字段未初始化,会立刻 panic。Go 的反射不检查业务逻辑,只做底层类型操作,所以必须提前确保:
– 类型是导出的(首字母大写)
– 构造函数签名统一(比如都接受 map[string]interface{}
– 所有被创建的 struct 都实现了同一接口,否则无法返回通用实例

reflect.TypeOfreflect.ValueOf 怎么配合注册与创建

工厂需要两个核心动作:注册类型、按名创建。注册阶段保存的是 reflect.Type(用于后续 New),而不是具体值;创建时用 reflect.New(t).Elem() 得到可寻址的零值实例,再通过反射设置字段或调用初始化方法。

  • 注册时存 reflect.Type,避免每次创建都重复调用 reflect.TypeOf
  • 创建后若需填充配置,用 v.FieldByName("Name").SetString("xxx"),但字段必须导出且可设置(CanSet() == true
  • 若用构造函数(如 NewMySQLClient),需用 reflect.ValueOf(fn).Call([]reflect.Value{...}),参数必须包装成 reflect.Value
package main

import (
	"fmt"
	"reflect"
)

type Client interface {
	Connect() string
}

type MySQLClient struct {
	Host string
	Port int
}

func (m MySQLClient) Connect() string {
	return fmt.Sprintf("mysql://%s:%d", m.Host, m.Port)
}

type RedisClient struct {
	Addr string
	DB   int
}

func (r RedisClient) Connect() string {
	return fmt.Sprintf("redis://%s/%d", r.Addr, r.DB)
}

var registry = make(map[string]reflect.Type)

func Register(name string, t interface{}) {
	registry[name] = reflect.TypeOf(t).Elem() // t 是指针,取其指向的类型
}

func Create(name string, config map[string]interface{}) (Client, error) {
	t, ok := registry[name]
	if !ok {
		return nil, fmt.Errorf("unknown client type: %s", name)
	}

	v := reflect.New(t).Elem() // 获取零值实例

	for key, val := range config {
		field := v.FieldByName(key)
		if !field.IsValid() || !field.CanSet() {
			continue
		}
		switch field.Kind() {
		case reflect.String:
			field.SetString(fmt.Sprintf("%v", val))
		case reflect.Int, reflect.Int64:
			field.SetInt(int64(val.(int)))
		}
	}

	// 确保返回接口类型,不是 reflect.Value
	return v.Interface().(Client), nil
}

func main() {
	Register("mysql", &MySQLClient{})
	Register("redis", &RedisClient{})

	c1, _ := Create("mysql", map[string]interface{}{"Host": "127.0.0.1", "Port": 3306})
	fmt.Println(c1.Connect()) // mysql://127.0.0.1:3306

	c2, _ := Create("redis", map[string]interface{}{"Addr": "localhost:6379", "DB": 0})
	fmt.Println(c2.Connect()) // redis://localhost:6379/0
}

不用反射的替代方案更简单也更安全

纯反射工厂在 Go 里属于“能跑但不推荐”的做法。真正上线项目中,几乎都用闭包注册 + 显式构造函数:

  • 每个 client 自带 NewXXX(config) 函数,返回接口
  • 工厂用 map[string]func(map[string]interface{}) Client 存注册项
  • 完全绕过反射,编译期检查类型,IDE 可跳转,性能无损耗
  • 只有极少数场景(如插件动态加载、配置驱动的 CLI 工具)才值得引入 reflect
反射工厂最难缠的不是写法,而是错误信息模糊——panic 时只报 reflect: Call using zero Valuecannot set unexported field,得一层层查 CanAddr()CanSet()IsValid() 才能定位。实际开发中,宁可多写几行注册代码,也不要靠反射省那几行。