不能在Fiber handler里直接调ch.Publish(),因handler生命周期极短,响应写出后连接可能立即关闭,此时publish易panic或静默丢消息;须用缓冲channel解耦,由独立goroutine异步处理重试、重建连接与失败落库。

不能在 Fiber handler 里直接调 ch.Publish() 或 ch.Consume(),否则连接一断就静默失效,消息丢得毫无痕迹。
为什么 Fiber handler 里调 ch.Publish() 会丢消息
HTTP 响应一旦写出(w.WriteHeader() 或 w.Write()),底层连接可能被复用或立即关闭。此时若 ch.Publish() 遇到网络抖动、channel 已关闭、队列不存在(AMQP error 404),要么 panic,要么静默失败——连日志都难捕获。
- 现象:接口返回快,但下游 RabbitMQ 挂了,消息就彻底消失,无重试、无告警
- 根本原因:handler goroutine 生命周期太短,无法承载异步投递的可靠性保障逻辑
- 正确姿势:handler 只做两件事——序列化消息体、写入带缓冲的
chan []byte(如make(chan []byte, 1000));独立 goroutine 持续消费该 channel,封装publishToRabbitMQ()统一处理重试、连接重建、失败落库
amqp.Dial() 连不上 RabbitMQ 的三大检查点
八成不是代码写错,而是环境没对。别急着改 Go,先按顺序排查:
- 用
nc -zv rabbitmq 5672(容器内请用服务名,不是localhost)确认端口通——Docker 场景下,Go 服务若也在容器中,localhost指的是它自己 - 连接字符串是否含
connect_timeout=5和heartbeat=30?缺一不可;amqp.Dial()默认无限阻塞,DNS 失败时卡死无报错 - 启用了 TLS?必须改用
amqps://协议,并传入带TLSClientConfig的amqp.DialConfig,否则 handshake 卡住不报错
消费者必须设 autoAck: false 且首行 defer msg.Ack(false)
RabbitMQ 的消费模型是“收到→干活→显式 Ack→再收下一条”,不是“收到就干”。把 msg.Ack(false) 写在业务中间,一旦前面 panic、DB 报错或提前 return,Ack 就被跳过,消息卡在 unacked 状态,积压后触发流控,整个 consumer 停摆。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
立即学习“go语言免费学习笔记(深入)”;
- 安全写法:consumer handler 开头第一行就是
defer msg.Ack(false) - 业务逻辑成功后再调
msg.Ack(true);失败则msg.Nack(false, true)(requeue=false),避免无限重试压垮下游 - 必须配
ch.Qos(1, 0, false)控制预取数量,否则一个慢任务会饿死其他消息 - 幂等校验建议用 Redis
SETNX,键为"event_type_business_id"(如"notify_user_123")
消息持久化失效的两个隐藏条件
DeliveryMode: amqp.Persistent 不等于消息真能落地——它只是告诉 broker “请存盘”,但 broker 是否真存,取决于队列本身是否声明为 durable: true。两者缺一不可。
- 队列声明时漏掉
durable: true→ 消息进内存,Broker 重启即丢 - 发消息时没设
mandatory: true→ 路由失败时不报错,消息静默消失 - 真正可靠要配
channel.Confirm(false)+channel.NotifyPublish()监听确认,超时(如 500ms)未收到 ACK 就记日志+告警
最常被忽略的点:所有 amqp.Publishing 实例必须每次新建,不能复用。因为其内部 Headers map 是引用类型,复用会导致并发写竞争、字段污染,甚至触发 RabbitMQ 的 PRECONDITION_FAILED - unknown delivery tag 错误。

















