Go 应用 fx 依赖注入与生命周期
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/samber-cc-skills-golang-golang-uber-fx。
技能介绍
要解决什么问题
长驻型 Go 服务(HTTP、Worker、守护进程)往往要在单进程内把数据库、路由、指标、后台任务拼成一张依赖图,同时保证启动顺序可预测、收到 SIGINT/SIGTERM 后能有序停机。若在 init() 或构造函数里直接起 goroutine,拓扑外的启动顺序和泄漏很难控;裸用 dig 只有容器,没有生命周期与信号循环。
技能如何帮你组织应用
本技能以 uber-go/fx 为视角:在组合根用 fx.Provide / fx.Invoke 注册与触发构造;用注入的 fx.Lifecycle 把长耗时工作放进 OnStart/OnStop,并强调 OnStart 须快速返回、阻塞任务在 hook 内起 goroutine。fx.Module 把一类能力(HTTP、DB、指标)收成可复用单元,装饰器仅作用于模块子树。fx.In / fx.Out、fx.Annotate、value group(如 group:"routes")对应 dig 同名能力;fx.Supply 用于已有配置,app.Run() 负责信号感知的运行循环,默认启停超时 15 秒 可用 fx.StartTimeout / fx.StopTimeout 覆盖。
适用边界与注意点
- 选 fx:长驻服务且需要生命周期与信号处理;选 dig:CLI、可嵌入容器、测试 Harness,见关联 dig 技能。
- Value group 不保证顺序;需要顺序时由单一构造器提供有序 slice。
- 构造器宜轻量、副作用进 OnStart;无
Invoke链到的类型不会执行构造。 - CI 可用
fx.New(...).Err()校验图;集成测试见fxtest、fx.Replace、fx.Populate。
使用场景
- 新 HTTP 服务要在 main 里用模块拆分路由、数据库与指标,并保证 SIGTERM 时连接与后台任务按拓扑逆序关闭
- 多个 `fx.Provide` 向同一接口注册实现,需要用 value group 聚合后由单一消费者挂载到健康检查或路由表
- 在 CI 流水线里仅启动 `fx.New` 校验依赖图,避免缺 Provider 或循环依赖上线后才暴露
- 集成测试里用 `fx.Replace` 换假实现、`fx.Populate` 拉出图内实例,并用 `fxtest` 绑定 `t.Cleanup` 做停机
适合人员
- 负责微服务骨架的 Go 后端工程师,希望把启停逻辑从散落 goroutine 迁到 fx 生命周期钩子里
- 维护多模块单体或 Worker 的架构师,需要按 `fx.Module` 划分装饰器作用域并控制模块对外 Provide 的类型
- 写过 dig 容器的开发者,正在评估长驻进程是否应升级到带 `app.Run()` 的 fx
- 编写服务级集成测试的工程师,需要把 fx 图校验与 `fxtest` 停机模式纳入常规测试套件