Echo框架本身不提供依赖注入容器，所有依赖须手动传递或借助Wire等第三方编译期DI工具实现；强行将服务塞入echo.Context违反Clean Architecture，因Context是请求级对象而非服务容器，且导致耦合、不可测、无编译检查。
直接说结论：Echo 框架本身不提供依赖注入容器，echo.Echo 实例只是 HTTP 路由器，所有依赖必须手动传递或借助第三方 DI 库（如 uber/fx、google/wire 或自建轻量注册表）完成注入；强行在 echo.Context 里塞服务实例，是 Clean Architecture 的典型反模式。
为什么 Echo 不自带 DI 容器？
Echo 的设计哲学是极简——它只做路由、中间件、响应封装三件事。不像 Gin 或 Fiber 那样内置 Engine 级别上下文绑定机制，Echo 的 echo.Context 是请求生命周期对象，不是服务容器。往里面挂 db、userRepo 或 logger，会导致：
- 业务 handler 与框架强耦合，无法脱离 Echo 单元测试
- 违反 Clean Architecture 的依赖规则：表现层（HTTP handler）不该持有基础设施层（如
mongo.Collection）的具体引用 -
echo.Context.Set()和.Get()是运行时反射操作，无编译期检查，容易拼错 key 或类型断言失败
用 Wire 实现编译期安全的依赖注入
google/wire 是 Go 社区最主流的 compile-time DI 工具，适合 Clean Architecture 分层场景。它不运行时扫描，而是通过代码生成器把依赖图“硬编码”进 main.go，彻底规避反射和魔法字符串。
关键点：
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
- 定义 provider 函数（返回具体实现），例如
NewUserRepository(db *mongo.Database)、NewUserUsecase(repo domain.UserRepository) - 编写
wire.go文件，用wire.Build()声明依赖链起点（通常是*echo.Echo构造函数） - 运行
wire generate，生成wire_gen.go—— 里面全是显式的 new 和传参，可读、可 debug、可 profile - 最终在
main()中调用生成的InitializeEcho()，拿到已注入全部依赖的*echo.Echo
示例片段（非完整）：
// wire.go
func InitializeEcho() (*echo.Echo, error) {
wire.Build(
echo.New,
NewUserRepository,
NewUserUsecase,
NewUserController,
// ... 其他 provider
)
return nil, nil
}
HTTP handler 层如何符合 Clean Architecture 规则？
handler 只负责三件事：解析输入（query/path/json）、调用 usecase、序列化输出。它不能直接访问 mongo.Collection、redis.Client 或 config.Env。
- 所有外部依赖必须通过构造函数注入到 controller（即 handler 的 struct 封装体），例如：
type UserController struct { usecase domain.UserUsecase } - handler 方法签名保持为
func(echo.Context) error，但内部调用的是c.usecase.Create(...)，而非repo.InsertOne(...) - 不要在 handler 里做任何业务判断（如“余额不足则拒绝”），那是 usecase 的职责；也不要格式化时间、拼接 URL，那是 presenter 或 adapter 的事
- 错误处理统一交给 middleware（如
HTTPErrorHandler），handler 内只 return error，不写c.JSON(400, ...)
基础设施层注册时最容易忽略的生命周期问题
数据库连接、Redis 客户端、JWT 密钥这些资源，必须在应用启动时初始化一次，并在退出时关闭。Wire 本身不管理生命周期，需手动处理：
-
*mongo.Client和*redis.Client应作为顶层 provider，被所有 repository 共享，而不是每个 repo 都 new 一个 - 用
fx.Invoke()（如果选uber/fx）或在main()末尾显式调用defer client.Disconnect() - 避免在 provider 函数里做耗时操作（如连接 DB），否则
wire.Build会卡住；应拆成两个函数：NewMongoClient()（快速返回 client）和EnsureDBConnection()（单独 invoke） - 环境配置（如
.env加载）必须早于所有依赖注册，否则NewUserRepository可能拿不到os.Getenv("MONGO_URI")
真正的难点不在怎么写 DI，而在于分清「谁该创建谁」「谁该销毁谁」——Clean Architecture 的每一层都只对紧邻内层负责，外层永远不感知内层资源的生命周期。这点在 Echo 这种无侵入框架里，反而更需要开发者主动划清边界。
