Beego无运行时控制器热补丁能力,开发期依赖bee run自动重启实现伪热重载,生产期需grace包+SIGHUP手动升级;二者机制不同、不可混用,且默认仅监听.go文件。

Beego 没有运行时替换控制器的“热补丁”能力,所谓“优雅重载”实际是两种不同机制的混合使用:开发期靠 bee run 自动重启(快但会断连接),生产期靠 grace 包 + SIGHUP 实现零停机升级(需手动触发、不自动监听文件)。两者不能混用,选错场景会导致热重载失效或连接中断。
bee run 是开发期唯一有效的“热重载”方式
它不是真正的热加载,而是监听源码变更后杀掉旧进程、启动新进程。之所以“够用”,是因为 Beego 启动极快,且默认 dev 模式下禁用长连接复用、模板缓存等干扰项。
- 必须用
bee run启动,go run main.go或二进制直接运行完全不触发监听 - 默认只监听
.go文件;改了views/下的.tpl或conf/app.conf不会重启,需手动加bee.json配置watch_ext - 修改
controllers/目录下的文件时,若结构体没嵌入beego.Controller或方法名不是Get/Post开头,重启后路由仍不生效——这是代码规范问题,不是热重载失效 - 每次重启都会重置内存 Session(如
session.SessionProvider = "memory"),不适合依赖会话状态的调试
grace.ListenAndServe 支持 SIGHUP 但不自动监听文件
这是生产环境平滑升级的路径,和开发期热重载无关。它靠 Unix 信号通知当前进程“准备退出”,同时 fork 新进程监听同一端口,旧连接处理完才真正退出。
- 必须用
grace.ListenAndServe替换原生http.ListenAndServe,否则kill -HUP无响应 -
grace包本身不监听文件变化,也不会自动编译;你得先手动go build出新二进制,再发信号 - 旧进程收到
SIGHUP后,会等待活跃 HTTP 连接自然结束(比如长轮询、流式响应),但不会等无限久——默认超时 60 秒,可传grace.GracefulTimeout调整 - 监听端口必须能被多个进程复用(Linux 上需
SO_REUSEPORT,Go 1.11+ 默认支持;macOS 不支持该语义,SIGHUP 升级在 macOS 上不可靠)
bee.json 配置 watch_ext 才能让非 .go 文件触发重启
很多人以为改了模板或配置就能热刷新,结果发现没反应——因为 Bee 默认忽略它们。要让 .tpl、.conf、.html 修改也触发 bee run 重启,必须显式声明。
- 在项目根目录新建
bee.json,内容至少包含:{ "watch_ext": [".go", ".tpl", ".conf", ".html"] } -
bee run启动时会自动读取该文件;改完保存后,Bee 会触发完整重启(包括重新 parse app.conf、reload template cache) - 注意:
.js、.css等静态资源改了也触发重启,但 Beego 默认不托管这些路径(除非你配了StaticDir),实际意义有限 - 如果
bee.json存在但格式错误,bee run会静默失败并退回到只监听.go的默认行为,建议用jsonlint校验
最容易被忽略的是环境切换成本:开发用 bee run,生产用 grace + 信号,二者启动方式、日志输出、错误堆栈位置完全不同。同一个 main.go 文件里混写两种逻辑,很容易在部署时漏掉 grace 初始化,或者误把 bee.json 提交到生产镜像里。


















