Uber FX 强制代码按其结构组织，启动失败常见于缺少构造函数或类型未注册；必须用 fx.Provide 显式注册返回具体类型的构造函数，fx.Invoke 仅接受参数可解析且返回 error 的函数，自定义日志需实现 fxevent.Logger 接口，fx.Supply 仅适用于具体值注入。
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 实现。
立即学习“go语言免费学习笔记（深入）”；
- 错误做法：
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 错误的机会。
