生命周期管理

Weaver 组件支持以下生命周期钩子，全部为可选实现：

钩子	签名	说明
Init	Init(ctx context.Context) error	组件初始化时调用，返回 error 会阻断启动
Start	Start(ctx context.Context) error	组件启动时调用，适合长时间运行的服务
Shutdown	Shutdown(ctx context.Context) error	组件关闭时调用，用于释放资源

Init

Init 在组件实例化完成后立即调用，此时依赖注入（WithConfig、Ref）已经完成，可以安全地访问配置和依赖的组件。

Start

实现了 Start 的组件会在 weaver.Run 启动主逻辑前并发启动：

func (s *serverImpl) Start(ctx context.Context) error {
    s.Logger(ctx).Info("Starting HTTP server")
    return s.server.ListenAndServe()
}

Start 阶段的行为：

• 所有组件通过 errgroup 并发启动，任一组件失败都会触发整体退出
• 组件 panic 会被 recover 并视为启动失败
• Start 正常返回即视为该组件运行结束（长驻服务应阻塞在 Start 内，如 ListenAndServe）

Shutdown

Shutdown 在以下时机被调用：

• 主逻辑返回后，weaver.Run 退出前统一关闭所有组件
• 收到系统信号（SIGINT / SIGQUIT / SIGTERM）导致 ctx 取消后
• 配置文件热更新触发组件重启时（先 Shutdown 再 Start）

func (a *app) Shutdown(ctx context.Context) error {
    a.Logger(ctx).Info("App Shutdown")
    return nil
}

信号处理与主动退出

weaver.Run 内部使用 signal.NotifyContext 监听 SIGINT、SIGQUIT、SIGTERM，收到信号后取消上下文。

组件可以通过 Exec() 主动触发优雅退出（等价于向进程发送退出信号）：

func (a *app) Init(ctx context.Context) error {
    go func() {
        // 某种满足退出条件时
        a.Exec()
    }()
    return nil
}

完整流程

weaver.Run
 ├─ 解析 -conf / -version 参数
 ├─ 加载配置文件
 ├─ 实例化 Main 组件（级联实例化其依赖）
 ├─ 并发调用所有组件的 Start
 ├─ 执行主逻辑 app(ctx, main)
 └─ 退出时统一调用所有组件的 Shutdown