必须用闭包注册而非直接存结构体指针,因闭包可延迟执行、避免导入时触发证书加载、TCP连接等副作用,且支持捕获配置变量实现参数定制;结构体直传会提前初始化并绕过构造校验。

延迟加载必须靠闭包,不能直接存实例
工厂注册表里写 registry["http"] = &HTTPParser{} 是典型错误:包一导入就执行初始化,证书路径未配置、broker 地址为空、TCP dial 阻塞全在这儿爆发。真正该存的是 func() Parser 类型的闭包,调用时才 new 实例。
闭包还能捕获当前包的配置变量,比如 timeout 或 maxBodySize,比每次传参更轻量;而结构体直传既无法定制参数,又绕过构造函数里的校验逻辑。
- 注册必须在
init()或显式初始化阶段完成,不能等到第一次NewParser("http")时再注册 - 若构造需外部配置(如从 Viper 读 DB 地址),应改用
Register(name, ctor)显式调用,避免init()阶段依赖未就绪 - 所有副作用(打开文件、连数据库、初始化连接池)必须收进具体类型的
NewXXX()内部,工厂分发逻辑里只做查表和调用
并发安全要按场景选同步机制
注册阶段通常是单次、启动期行为,用 sync.Once 初始化 map 就够了;但若运行时还需动态注册(比如插件热加载),就得上 sync.RWMutex 包裹读写——读多写少场景下,读锁不互斥,性能影响小。
注意别把锁粒度搞错:不是给整个工厂加锁,而是保护注册表本身。工厂函数 NewParser() 只读 map,无需写锁;只有 Register() 才需要写锁。
- 别在
init()里做耗时操作(如读大配置文件),否则阻塞整个程序启动 - 若初始化可能失败(比如证书加载失败),错误必须存在字段里,避免下次调用重试导致 panic
- map 本身非并发安全,直接读写会触发 runtime panic,Go 1.26 依然如此
工厂返回接口,不是具体类型
如果 NewParser() 返回 *HTTPParser 而不是 Parser 接口,调用方就会绕过契约,后续加个 *MQTTParser 时没法透明替换——所有老代码都得改类型断言或强转。
工厂的核心价值不是“多态”,是“统一入口”和“策略可插拔”。只要接口定义稳定(比如 Parse([]byte) (interface{}, error)),新增协议只需注册闭包,业务层完全无感。
- 返回具体类型会让测试变难:mock 不了,只能靠真实实现跑通
- 若某协议解析器需带 context 或自定义 logger,应在闭包里注入,而不是暴露构造参数给工厂函数
- 别为了“模式完整性”硬套抽象工厂——90% 的协议解析场景,一个带选项的简单工厂 + 接口就足够
错误处理必须分层,不能吞掉底层 panic
注册时闭包内 panic(比如空指针解引用、证书路径为空)会被 init() 捕获并终止程序,这是好事;但运行时调用闭包后 panic(比如 Parse() 中未处理的 EOF),就得靠调用方自己 recover,工厂层不该吞掉。
常见错误是工厂函数里加 defer func() { if r := recover(); r != nil { ... } }(),结果把本该暴露的 bug 隐藏成静默失败,排查时卡在“为什么没日志也没错误”。
- 注册阶段 panic 应立刻暴露,宁可启动失败,也不带病运行
- 运行时错误统一走
error返回,不要用 panic 替代业务错误 - 若协议包通过匿名导入触发注册(
_ "myapp/protocol/http"),务必确保其init()里没有不可恢复的副作用
延迟加载和工厂模式结合的关键,不在语法技巧,而在控制「谁在什么时候做了什么」——注册时机、闭包封装、接口返回、错误分层,每一步错位都会让系统在上线后某天凌晨三点开始报错。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











