浏览文档目录

进阶主题

插件系统

通过插件接入外部系统,如队列、对象存储、告警与审批。

最近更新:2026-04-08阅读时长:6 分钟

生命周期

插件包含 Init、Start、Stop 三阶段。框架在启动时自动注入依赖,关闭时执行优雅退出。

插件接口

实现标准接口即可被加载。推荐将配置验证放在 Init 阶段。

type Plugin interface {
  Name() string
  Init(ctx context.Context, cfg map[string]any) error
  Start(ctx context.Context) error
  Stop(ctx context.Context) error
}

实践建议

插件开发遵循最小职责原则,避免将业务逻辑混入基础设施插件。

  • 一类插件只做一件事,例如只负责告警投递。
  • 为插件补充健康检查与超时保护。
  • 插件内部错误应标准化,便于监控系统聚合。

下一篇

配置体系