拆胖 main.go:不用 DI 框架的分层组装

拆胖 main.go:不用 DI 框架的分层组装

Hello,我是小兔大白糖。 评审里常听到一句:「main.go 都快两千行了,要不直接上 fx?」——听着干脆,落到单体 Go 服务里,却经常变成:要么继续往 main 里堆 New,要么把胖图原样搬进框架。写成这篇,给要做 Go 工程结构 / 启动组装选型 的初中级后端同学:不是某仓库的 main 重构工单,而是业界可复述的心智模型。

说明:下文包名、结构体名与伪流程均为教学脱敏示意,不是某开源项目或某公司的包路径说明书。读完带走的是「谁负责生命周期、层怎么装盒、关停怎么收口」,不是可粘贴的内部脚手架。fx / Wire 只谈公开文档可核对的形态与代价,不编造「大厂内部必须这样」。

估计阅读时间:10 分钟


目录


为什么现在要关心

硬规则先钉一句:main 只负责生命周期;组装图放进分层容器,别用「全局变量袋」或巨型参数列表顶替边界。

现场里常见的误伤,几乎都来自把「能跑」当成「结构已经够了」:

你看到的现象常见真相
改一个构造签名,main 要改三处组装与业务缠在同一文件
测一条路由要起全栈没有可替换的一层边界
进程关不干净 / 关停顺序随机defer 散落,没有单一 cleanup 合同
main.go 七十多个 import文件承担了整张应用依赖图
上了 DI,调试仍像魔术模块边界没画清,只是换了装配语法

另一条业界常见路(本文主线):显式分层容器 + cleanup 闭包 + 瘦 main——不引入 DI 框架,仍保持可测与可关停。代价是样板代码;收益是依赖图仍然可读。

与「窄角色接口」是互补题,不是替代题:组装根仍显式,依赖形状见 /blog/go_interface_provider_vs_consumer/。语言选型本身另有尺子,见 /blog/go_vs_java_backend_choice/。

胖 main 与瘦 main 加 app 包对照
胖 main 与瘦 main 加 app 包对照 · 点击查看 SVG 原图

问题空间:胖 main 在交什么税

胖 main 的税是变更面与关停合同,不是「不够面向对象」。

痛点表象根因
难改构造签名一动,main 多处跟着改组装与业务缠在一起
难测不起全栈测不了路由 / handler无边界,无法替换一层
难关停defer 散落,顺序偶发错误无单一 cleanup 合同
难读import 墙 + 局部变量墙单文件承担了应用图

可选路径(调研用标签,不是「必须选 C」的工单结论):

路径做法优点代价 / 边界
A. 继续胖 main最少搬迁短期零摩擦长期变更税与关停风险
B. DI 框架(如 fx / Wire)声明模块、自动构图(Wire 偏编译期生成,fx 偏运行时模块——形态不同,代价都是要会读图)模块化语法、图可生成学习曲线;故障时要会读注入图
C. 显式 provider 容器(本文)手写 NewXxx,分层结构体图可见、调试直接样板多;层一多仍要自律切域

实践上很少「永远只选一个」:小服务可以停在 C 的简化版;团队大、模块多再评估 B。不要用框架掩盖仍混乱的边界——那只是把胖 main 搬进了框架。


心智模型:装配车间,不是魔术箱

每一层 NewXxx(...) 是车间工位:吃上一层盒子,吐出本层盒子;cleanup 是下班关灯清单,按创建的逆序执行。

人话对照:

车间说法工程含义
工位NewInfrastructure / NewRepositories / …
盒子层容器结构体(字段是本层产物)
关灯清单cleanup func() 或等价 Shutdown
自动传送带DI 框架:方便,故障时要会读图

类比局限:装配车间解释的是组装与生命周期;解释不了业务域怎么切、接口契约归谁——那是域划分与 /blog/go_interface_provider_vs_consumer/ 的题。

Infra 到 Router 的层容器流水线
Infra 到 Router 的层容器流水线 · 点击查看 SVG 原图

精确定义:四条硬规则

可复述的合同只有四条;多出来的「六层盒子」往往是为拆而拆。

  1. main 只负责生命周期
    读配置 → app.New → Run → 信号 → Shutdown。别在 main 里 new 三十个服务。

  2. 按层装盒,不按「全局变量袋」
    Infra / Repos / Services / Handlers / Middleware 各一个容器结构体。盒子消灭的是散落局部变量,不是业务语义。

  3. 资源关闭用 cleanup 闭包(或等价 Shutdown)统一收口
    逆序关;失败的半成品路径也要部分清理。避免 main 里散落一堆互不相关的 defer。

  4. 路由按域拆文件
    巨型 registerRoutes(30+ args) 是耦合信号,不是「集中方便」。Router 持有 Handlers 指针,而不是三十个参数。

「层」在这里是组装边界,不是强制人人都上六层 DDD。两三个依赖的小工具进程,硬套全套盒子,税会反过来。


目标骨架与伪流程

教学向目录(脱敏,非某仓库路径):瘦 main 在 cmd,组装图在 internal/app,路由按域拆。

cmd/server/main.go       # ~30 行:New + Run
internal/app/
  app.go                 # App, New, Run, Shutdown
  infra.go               # DB / 缓存 / 外部客户端 + cleanup
  repository.go
  service.go
  handler.go
  middleware.go
  server.go              # HTTP/RPC 服务器装配
  router/                # 按域拆路由文件

伪流程(教学示意,非生产 API):

cfg := Load()
infra, cleanup, err := NewInfrastructure(cfg)
repos := NewRepositories(infra)
services := NewServices(repos, infra)
handlers := NewHandlers(services)
app := &App{..., cleanup: cleanup}
app.Run()   # serve → signal → Shutdown → cleanup()

BLUF:创建顺序从上到下;关停顺序从下到上。读完这两句,骨架就能复述给同事。


关键设计点

容器、cleanup、App 生命周期、域路由——四件事各管一件合同。

容器结构体

把「三十个局部变量」收成「五六个盒子」。调用方依赖的是盒子上的字段,而不是 main 作用域里的临时名。样板代码是代价;可读的依赖方向是收益。

cleanup 闭包

常见形态:NewInfrastructure 返回 (T, func(), error)。成功路径由 App.Shutdown 统一调用;中途失败也要在返回 error 前清掉已打开的资源——否则测试与热重启会漏连接。

与「每个 Open 旁边立刻 defer Close」不对立:defer 适合函数局部;跨层共享的长生命周期资源,更适合收口到单一 cleanup 合同。

cleanup 逆序关停示意
cleanup 逆序关停示意 · 点击查看 SVG 原图

App 生命周期

Run 阻塞服务并等信号;Shutdown 先停流量(拒绝新请求 / 等 in-flight),再跑 cleanup。顺序反了,常见后果是:连接池已关,请求还在打——表现为随机报错,而不是干净退出。

路由按域

auth / user / chat… 各文件注册自己的路由。技术层拆文件(middleware.go vs handler.go)解决不了「一个函数五百行、三十个参数」——那是域边界没切开。


反模式

从工程结构视角看,下面几条会把「瘦 main」重新揉成胖图。

  1. 拆了文件,仍把所有 New 堆回 main
    文件变多了,组装合同没变——只是分散了阅读路径。

  2. 引入 DI 却不画模块边界
    框架成了语法糖版胖 main。故障时既要懂业务,又要会读注入图。

  3. cleanup 与创建同向
    应逆序。同向关停容易先拆底层、上层还在用。

  4. 路由按技术层拆,却仍一个注册函数五百行
    缺的是域边界,不是又一个 routes_http.go。

  5. 为拆而拆:两三个依赖也上六层盒子
    样板税大于收益。层数服从依赖复杂度,不服从「看起来专业」。

  6. 用「全局变量袋」假装容器
    var DB *sql.DB 满天飞,测试与多实例启动都会疼。盒子要的是显式传入,不是包级可变状态。


选型结论

  1. 胖 main 交的是变更与关停税,不是 OOP 课没修好。
  2. 无框架显式组装是合法业界选项:代价是样板,收益是图可读、调试直接。
  3. 最小可落地组合:层容器 + cleanup(逆序)+ 瘦 main + 域路由。
  4. 团队大、模块多再评估 fx / Wire;框架补的是装配语法,补不了仍混乱的边界。
  5. 与窄角色接口互补:组装根显式;依赖形状变窄——见 /blog/go_interface_provider_vs_consumer/。栈选型另议 /blog/go_vs_java_backend_choice/。