Go语言fx依赖注入教程【收藏】

Uber FX 是一个“零容忍”的 Go 依赖注入框架，它不提供灵活的隐式绑定或运行时容错，而是强制开发者在启动前就用 fx.Provide 显式声明所有构造函数、用 fx.Invoke 精确控制一次性启动逻辑、用 fx.Annotate 明确标注接口实现，并严格区分 fx.Supply（仅注入具体值）与 fx.Provide（参与依赖解析）——任何类型未注册、接口未标注、日志未适配或构造函数含阻塞操作，都会导致 fx.New() 直接 panic，让你在启动阶段就暴露架构问题，而非埋下运行时隐患。

Uber FX 不是“学了就能上手”的依赖注入库，它强制要求你按它的结构组织代码，否则连启动都失败。

fx.New() 启动失败：missing constructor 或 panic: no constructors provided

这是最常卡住人的第一步。FX 不接受零散的 func 注入，必须用 fx.Provide 显式注册构造函数，且每个构造函数必须返回具体类型（不能是 interface{}），参数也得是 FX 已知的类型。

• 常见错误：直接传一个已实例化的对象，比如 fx.Provide(db) —— 不行，必须传 func() *sql.DB { ... }
• 正确写法：fx.Provide(newDB, newHandler, newService)，每个函数都得是“可构造的”
• 如果构造函数依赖未注册类型，FX 会报 missing type *http.ServeMux 这类错误，不是缺包，是没用 fx.Provide 提供它
• 注意：构造函数里别做耗时初始化（如连接数据库），FX 启动阶段会同步执行所有 Provide 函数，阻塞启动

fx.Invoke() 里调用函数不执行？或提示 unknown type

fx.Invoke 是用来运行“一次性逻辑”的，比如启动 HTTP server、订阅消息队列，但它只认函数签名：所有参数必须是 FX 容器里能解析出的具体类型，返回值必须是 error 或空。

• 错误示例：fx.Invoke(func(svc Service) { svc.Start() }) —— 如果 Service 是接口，而你只提供了 *ServiceImpl，FX 默认不自动转换，会报 unknown type Service
• 解决办法：用 fx.Annotate 显式标注返回接口，比如 fx.Provide(fx.Annotate(newServiceImpl, fx.As(new(Service))))
• 另一个坑：fx.Invoke 函数不能有未使用的参数，哪怕类型对得上，FX 也会拒绝启动

fx.WithLogger() 自定义日志不生效？或 panic: logger is not a *zap.Logger

FX 内置日志系统硬依赖 *zap.Logger，如果你用 logrus 或 zerolog，不能直接塞进去，必须包装成符合 FX 接口的 fxevent.Logger 实现。

• 错误做法：fx.WithLogger(func() *logrus.Logger { return logrus.New() }) —— 类型不匹配，启动直接 panic
• 正确路径：要么换回 zap，要么实现 fxevent.Logger 接口并用 fx.WithLogger(yourAdapter)
• 注意：FX 的 fx.NopLogger 是空实现，适合测试，但不会输出任何内容，别误以为“日志关了”是配置问题

fx.Supply() 和 fx.Provide() 混用时，为什么值没被注入？

fx.Supply 是用来“提供值”，不是“提供构造逻辑”，它跳过 FX 的生命周期管理，也不参与依赖解析链。它只在你明确需要把某个固定值（比如配置 struct）塞进容器时才用。

• 典型误用：fx.Supply(config) + fx.Invoke(func(c Config) {}) —— 如果 Config 是 interface，FX 无法从 Supply 的值反推类型，会报错
• 安全用法：fx.Supply(Config{Port: 8080}) 配合 func(c Config)（注意是具体 struct 类型，不是 interface）
• 优先选 fx.Provide：即使只是返回固定值，也写成 func() Config { return Config{...} }，这样 FX 能完整跟踪类型和依赖

FX 最难适应的不是语法，而是它不让你“先写逻辑再补依赖”——所有构造入口、依赖关系、生命周期钩子，必须在 fx.New() 里一次性声明清楚。少一个 fx.Provide，多一个未标注的 interface，它就拒绝启动，不给你 runtime 错误的机会。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Go语言fx依赖注入教程【收藏】》文章吧，也可关注golang学习网公众号了解相关技术文章。