
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 的税是变更面与关停合同,不是「不够面向对象」。
| 痛点 | 表象 | 根因 |
|---|---|---|
| 难改 | 构造签名一动,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/ 的题。
精确定义:四条硬规则
可复述的合同只有四条;多出来的「六层盒子」往往是为拆而拆。
-
main 只负责生命周期
读配置 →app.New→Run→ 信号 →Shutdown。别在 main 里new三十个服务。 -
按层装盒,不按「全局变量袋」
Infra / Repos / Services / Handlers / Middleware 各一个容器结构体。盒子消灭的是散落局部变量,不是业务语义。 -
资源关闭用 cleanup 闭包(或等价 Shutdown)统一收口
逆序关;失败的半成品路径也要部分清理。避免 main 里散落一堆互不相关的defer。 -
路由按域拆文件
巨型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 合同。
App 生命周期
Run 阻塞服务并等信号;Shutdown 先停流量(拒绝新请求 / 等 in-flight),再跑 cleanup。顺序反了,常见后果是:连接池已关,请求还在打——表现为随机报错,而不是干净退出。
路由按域
auth / user / chat… 各文件注册自己的路由。技术层拆文件(middleware.go vs handler.go)解决不了「一个函数五百行、三十个参数」——那是域边界没切开。
反模式
从工程结构视角看,下面几条会把「瘦 main」重新揉成胖图。
-
拆了文件,仍把所有
New堆回 main
文件变多了,组装合同没变——只是分散了阅读路径。 -
引入 DI 却不画模块边界
框架成了语法糖版胖 main。故障时既要懂业务,又要会读注入图。 -
cleanup 与创建同向
应逆序。同向关停容易先拆底层、上层还在用。 -
路由按技术层拆,却仍一个注册函数五百行
缺的是域边界,不是又一个routes_http.go。 -
为拆而拆:两三个依赖也上六层盒子
样板税大于收益。层数服从依赖复杂度,不服从「看起来专业」。 -
用「全局变量袋」假装容器
var DB *sql.DB满天飞,测试与多实例启动都会疼。盒子要的是显式传入,不是包级可变状态。
选型结论
- 胖 main 交的是变更与关停税,不是 OOP 课没修好。
- 无框架显式组装是合法业界选项:代价是样板,收益是图可读、调试直接。
- 最小可落地组合:层容器 + cleanup(逆序)+ 瘦 main + 域路由。
- 团队大、模块多再评估 fx / Wire;框架补的是装配语法,补不了仍混乱的边界。
- 与窄角色接口互补:组装根显式;依赖形状变窄——见 /blog/go_interface_provider_vs_consumer/。栈选型另议 /blog/go_vs_java_backend_choice/。