fx 启动失败主因是 fx.Provide 用法错误：只接受返回实例的构造函数，不接受已创建对象；传错类型、漏注册依赖或构造函数内做耗时操作均导致 panic。
fx 启动失败，八成是 fx.Provide 没写对——它不接受实例，只认构造函数；传错类型、漏注册依赖、在构造函数里做耗时操作，都会让 fx.New() 直接 panic。
fx.Provide 必须传函数，不能传实例
常见错误是把已创建好的对象直接塞进去，比如 fx.Provide(db) 或 fx.Provide(logrus.New())。FX 不会解析值，只执行函数并注入返回值。
- ✅ 正确：传一个返回具体类型的函数，如
func() *sql.DB { return sql.Open(...) } - ❌ 错误：传指针、接口或已实例化对象，FX 会报
missing constructor或panic: no constructors provided - ⚠️ 注意：函数参数必须是 FX 容器里已有类型，否则启动时报
missing type *http.ServeMux这类错误，不是缺包，是没用fx.Provide提供它
fx.Invoke 函数签名必须严格匹配
fx.Invoke 不是普通调用，它是 FX 在启动完成后自动执行的“一次性逻辑”，对函数签名极其敏感。
- 参数只能是容器中可解析的具体类型（如
*http.ServeMux），不能是未注册的接口（如Service） - 返回值只能是
error或空，多一个int都会启动失败 - 所有参数都必须被实际使用，哪怕类型对得上，但函数体里没引用，FX 也会拒绝启动
- 若需注入接口，必须用
fx.Annotate显式标注，例如：fx.Provide(fx.Annotate(newServiceImpl, fx.As(new(Service))))
fx.Supply 和 fx.Provide 别混用
fx.Supply 是“给值”，fx.Provide 是“给构造逻辑”。两者行为完全不同，混用会导致依赖无法解析。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
-
fx.Supply(42)注入的是字面值42，FX 不会尝试解析它的依赖，也不参与生命周期管理 -
fx.Provide(func() *DB { ... })才会触发依赖推导链，参数可被自动注入 - 如果某个结构体字段需要从
fx.Supply来的值，但构造函数又依赖其他fx.Provide类型，FX 不会帮你桥接——它不推导“值 → 类型”关系
自定义 logger 必须实现 fxevent.Logger 接口
fx.WithLogger 看似灵活，实则硬编码依赖 *zap.Logger。用 logrus、zerolog 或标准库 log 都会 panic。
- ❌ 错误写法：
fx.WithLogger(func() *logrus.Logger { return logrus.New() })—— 类型不匹配，启动即崩 - ✅ 正确路径：要么切回
zap，要么自己实现fxevent.Logger接口，再包装你的 logger -
fx.NopLogger是空实现，不会输出任何内容，别误以为是“日志关闭了”，其实是压根没生效
最易忽略的一点：FX 的构造函数在启动阶段同步执行，数据库连接、HTTP client 初始化这些耗时操作一旦放在 newDB() 里，整个应用就卡住不动——它们该交给 fx.Lifecycle 的 OnStart 钩子去异步处理。
