beego整合nsq需手动引入go-nsq并严格管理生命周期：producer须在addappstarthook中初始化、全局复用、显式stop；consumer须长驻运行、设maxinflight、recover panic并正确调用finish/requeue，避免消息丢失或静默失败。
Beego 本身不内置消息队列支持，整合 NSQ 必须手动引入 go-nsq 客户端并管理生命周期；关键不是“能不能接”，而是连接怎么稳、消息怎么不丢、Consumer 怎么不 panic 后静默失败。
Beego 应用启动时如何安全初始化 NSQ Producer
Beego 的 func main() 和 app.Run() 之间是唯一可靠时机——不能在 controller 初始化时才建 nsq.Producer，否则热重启或并发请求会触发重复创建和连接泄漏。
- 用全局变量或 Beego 的
AppConfig存储*nsq.Producer，并在beego.AddAPPStartHook中初始化 - 必须显式调用
producer.Stop()：Beego 没有优雅退出钩子，需监听os.Interrupt或syscall.SIGTERM，在 shutdown 前等待producer.Stop()返回 - 别裸用
producer.Publish()：HTTP handler 里直接调用会阻塞整个 goroutine。改用producer.PublishAsync()+ 自定义 error logger，或者封装成带context.WithTimeout的异步发送函数 - 检查
config.Verbose = true日志，确认是否出现io: read/write timeout或broken pipe—— 这类错误不会返回给Publish()调用方，但消息已丢失
NSQ Consumer 在 Beego 中该以什么方式启动
不能把 consumer.ConnectToNSQD() 放进 controller 或 model 里动态调用；Consumer 是长生命周期服务，必须随 Beego 进程一起启停，且要避免被 Beego 的 HTTP 请求复用机制干扰。
- 在
beego.AddAPPStartHook里启动 Consumer，并用sync.WaitGroup持有引用，防止 main goroutine 退出后 consumer 被 kill - 务必设置
c.SetMaxInFlight(10)：Beego 默认不限制并发，若 handler 处理慢（比如调外部 API），不设此值会导致 nsqd 停止投递新消息，表现就是“消息卡住” - Handler 函数内禁止启动 goroutine 后立刻 return：NSQ 认为消息已处理完毕，实际业务还在后台跑——结果是消息被 finish，但逻辑没执行完
- panic 必须 recover：Beego 不捕获 consumer handler 的 panic，一旦 panic，当前 goroutine 终止，消息既没
Finish()也没Requeue()，只能等超时重发。加一层defer func() { if r := recover(); r != nil { msg.RequeueWithoutDelay() } }()
Beego 热重启（bee run）时 NSQ 连接为何频繁断开
因为 bee run 是杀进程再拉新进程，旧进程的 producer 和 consumer 没机会调 Stop() 或 Close()，TCP 连接被内核强制关闭，nsqd 侧记录为 abrupt disconnect。
- 不要依赖
bee run做 NSQ 集成开发；本地调试改用go run main.go+ 手动信号控制（kill -TERM）更可控 - 所有
nsq.Producer和nsq.Consumer实例必须绑定到 Beego 的 App 生命周期：用beego.BeeApp.Shutdown注册清理函数（Beego v2.0+ 支持） - 如果必须用 bee，至少在
APP_START钩子里加连接健康检查：尝试producer.Ping()，失败则重建，避免复用已断开的连接句柄 - Consumer 的
ConnectToNSQD()调用前，先用net.DialTimeout("tcp", "127.0.0.1:4150", 500*time.Millisecond)验证端口可达，否则会卡在 connect 阶段阻塞整个启动流程
Topic/Channel 命名与 Beego 模块结构怎么对齐
NSQ 不识别 Beego 的包路径或 controller 名，但你可以用 Beego 的模块划分反向约束命名规则，避免 channel 冲突或消息误投。
- Topic 名建议用
beego.AppConfig.String("appname") + "." + "event"拼接，比如"user-service.register"，便于跨服务追踪 - Channel 名不应硬编码字符串，而应从配置读取：
beego.AppConfig.String("nsq.channel")，这样不同部署环境（dev/staging/prod）可用不同 channel 隔离流量 - 多个 Beego 实例消费同一 channel 时，确保它们共享相同
Consumer配置（尤其MaxInFlight和LookupdPollInterval），否则负载不均 - 别在 Beego 的
models包里定义 Topic 常量然后到处 import——这会让测试难 mock；改用接口抽象，如type NsqPublisher interface { Publish(topic, channel string, body []byte) error }
最易被忽略的是消息语义边界：Beego 的 HTTP 请求有明确生命周期，但 NSQ 消息没有。一旦把 msg.Finish() 放进 defer，又在 handler 里提前 return，消息就永远 finish 了——哪怕后续逻辑 panic 或超时。这事关“至少一次”能否落地，不是配置问题，是代码路径问题。
