Iris 不支持 BaseController 自动注入，必须显式传入依赖字段；注册时按类型顺序匹配控制器中可导出字段，嵌入结构体无效，推荐用独立 service 替代继承。
Iris 没有内置 BaseController 概念，必须手动实现继承链，且不能依赖框架自动注入父类字段。Iris 的 MVC 控制器注册机制只认你 new 出来的具体类型实例，不会递归扫描嵌入结构体或父类中的字段，更不支持类似 ASP.NET Core 的控制器基类生命周期管理。
为什么直接嵌入 struct 字段会失效
常见错误是这样写：
type BaseController struct {
DB *sql.DB
Logger *zap.Logger
}
type UserController struct {
BaseController // ❌ Iris 不会自动初始化这个字段
Service *UserService
}
结果是 c.DB 和 c.Logger 全为 nil —— Iris 只把传给 mvc.Register() 的值原样塞进控制器实例，不做任何字段级依赖填充。
- Iris 的
Register()接收的是任意 interface{} 值，它只做“值传递”，不反射解析结构体嵌套 - 没有类似 ASP.NET Core 的
IDependencyResolver或构造函数注入机制，父结构体字段不会被自动赋值 - 即使你在
BaseController里加了方法，只要字段没初始化，调用就会 panic
正确做法：用组合 + 显式字段注入
把 Base 类型的依赖作为**顶层字段显式声明**，并在注册时一并传入：
type BaseController struct {
DB *sql.DB
Logger *zap.Logger
}
type UserController struct {
DB *sql.DB `inject:""` // 仅作标记，实际不生效；Iris 不读这个 tag
Logger *zap.Logger `inject:""`
Service *UserService
}
// ✅ 正确注册方式
mvc.New(app.Party("/api")).Register(
db, // 对应 DB 字段
logger, // 对应 Logger 字段
userService, // 对应 Service 字段
).Handle(new(UserController))
- Iris 按
Register()参数顺序，依次匹配控制器结构体中**同类型、可导出**的字段 - 字段名无关紧要，类型匹配优先；多个同类型字段时行为未定义，务必避免
- 不要试图在
BaseController中放业务逻辑方法并期望子类复用——方法能调，但若依赖未初始化字段，运行时必崩
想复用逻辑？封装成独立 service 更安全
比起继承，Iris 更推荐将公共能力拆成可注入的 service：
type LoggerService struct {
*zap.Logger
}
func (s *LoggerService) Infof(ctx iris.Context, msg string, args ...interface{}) {
s.Info(fmt.Sprintf("[%s] %s", ctx.Request().URL.Path, msg), args...)
}
// 注册时传入
mvc.New(app.Party("/api")).Register(
db,
&LoggerService{logger},
userService,
).Handle(new(UserController))
- 所有控制器都可接收
*LoggerService，无需继承，无初始化歧义 - service 本身可带方法，字段也已明确初始化，调用完全可控
- 避免因字段匹配顺序错乱导致的隐性 bug（比如误把
*sql.DB赋给了Logger字段）
真正容易被忽略的是：Iris 的字段注入是纯类型驱动的“位置绑定”，不是基于名称或结构体嵌套的语义绑定。哪怕你花时间写了个漂亮的 BaseController，只要没把它拆成独立参数传进 Register()，它就只是个摆设。
