应采用工厂方法+接口抽象+配置驱动替代if-else硬编码,因后者违反开闭原则、引发耦合、并发隐患及维护困难;各渠道需独立实现messagesender接口,通过配置动态注册,内置重试、token刷新与幂等控制。

直接用 if-else 分支选渠道,半年后没人敢改;用工厂方法 + 接口抽象 + 配置驱动,才能稳住 5 种以上渠道的迭代节奏。
为什么不能在 handler 里 new EmailSender() 或 if channel == "sms"
常见错误现象:加个飞书支持就要动核心通知函数,改错一个分支导致钉钉消息发到企业微信;测试覆盖不到某条 else if,线上发错渠道还查不出日志。这类代码违反开闭原则,也埋下并发隐患——比如多个 goroutine 同时调 NewWeComSender(),若内部初始化带锁或网络请求,会拖慢整个服务启动。
- 硬编码实例(如
sender := &EmailSender{...})让渠道耦合进业务逻辑,无法按环境开关 -
switch cfg.Channel把所有创建逻辑塞进一个函数,一改全测,CI 压力大 - 没做初始化失败兜底,比如 SMTP 连接超时导致
NewEmailSender()panic,整个 HTTP handler 崩溃
怎么用工厂方法注册钉钉/企微/邮件等渠道
核心不是“写个工厂函数”,而是让每个渠道自己决定怎么造自己,并由配置统一调度。工厂返回的是 MessageSender 接口,不是具体结构体;构造参数来自 config.ChannelConfig,不是硬编码值。
Colly 是一个用于 Go 语言的快速开源爬取和爬虫框架。它适用于从简单的页面提取到异步爬虫处理大量页面集合,支持请求回调和结构化解析。
- 定义接口:
type MessageSender interface { Send(ctx context.Context, msg Message) error } - 每个渠道实现自己的结构体和工厂,例如
DingTalkSender要解析webhook_url和secret,WeComSender则需corp_id、agent_id和 token 刷新逻辑 - 工厂方法签名必须是
func NewSender(cfg config.ChannelConfig) (MessageSender, error),启动时遍历配置项动态注册,而不是写死map[string]func(){ "dingtalk": NewDingTalkSender } - 别把工厂做成单例——不同环境可能需要不同 SMTP 地址,每个渠道应有独立实例
异步分发时如何避免 goroutine 泛滥和 429 错误
通知不是强一致场景,但也不能无脑 go sender.Send()。瞬间几百告警进来,没控制的 goroutine 会打穿内存,还触发钉钉/企微频控返回 429 Too Many Requests,而你连重试都没做。
- 用带缓冲的 channel:
make(chan Message, 1000),防止上游突增压垮队列 - 固定 worker 数量消费,例如启动 3 个 goroutine 拉取并调
sender.Send(),避免每个消息都起新协程 - 每个
Send()实现里必须内置重试:对429或5xx状态码,用time.AfterFunc(30 * time.Second, func(){...})延迟重入队列;禁用无限 for 循环重试 - access_token 必须带刷新逻辑,且用
sync.RWMutex包裹字段,或存 Redis 并设过期时间——别在NewWeComSender()里一次性取完就全局缓存
测试时最容易漏掉的渠道差异点
不同渠道对消息格式、长度、编码的容忍度天差地别。共用一套模板,在钉钉上能发,在企微外部群里就静默失败,排查时连错误日志都没有。
- 钉钉卡片不认换行符
\n,得转成;企微外部群不支持base64图片,只认 URL -
message.Title在邮件里可为空,但在飞书卡片里是必填字段,长度不能超 128 字符 - 幂等键别用时间戳或用户 ID,数据库加唯一索引:
(channel, ext_id),插入前走INSERT ON CONFLICT DO NOTHING(PG)或INSERT IGNORE(MySQL) - 本地调试优先用
beeep.Notify()快速验证流程,再切到真实渠道;别一上来就跑 FCM,token 失效或 APNs 配置错会导致无声失败
真正难的不是写通一个渠道,而是让五种渠道在同一个配置结构下互不干扰地初始化、发出去、出错可定位、扩容不改代码——这些细节藏在工厂的参数校验、token 的并发读写保护、以及每条 Send() 调用里的重试策略里。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










