Buffalo框架默认不支持优雅重启，因定位开发优先；需让二进制直接作为PID=1并用http.Server+自定义信号处理器实现优雅关闭。
Buffalo 框架默认不支持优雅重启
Buffalo 的 buffalo dev 和 buffalo build 生成的二进制在收到 SIGTERM 时会直接退出，不等待 HTTP 连接关闭、不 drain 请求、不执行清理逻辑。这不是 bug，而是设计使然：Buffalo 定位是开发优先的快速原型框架，生产级生命周期管理需自行补全。
必须替换 PID=1 进程，否则 SIGTERM 根本收不到
容器中若用 sh -c "buffalo binary" 启动，shell 占据 PID=1，它既不转发信号，也不响应 SIGTERM —— Kubernetes 发出的终止信号会被直接忽略，最终触发强制 kill（SIGKILL），导致连接中断、资源泄漏。
- ✅ 正确做法：让 Buffalo 二进制**直接作为 PID=1**，例如 Dockerfile 中写
ENTRYPOINT ["./myapp"]，而非ENTRYPOINT ["sh", "-c", "./myapp"] - ❌ 常见错误：用
supervisord或自定义 shell wrapper 包裹启动，反而阻断信号链 - ⚠️ 验证方式：进容器执行
ps -o pid,comm，确认 PID=1 是你的应用进程名，不是sh或bash
用 buffalo.App().Serve() + 自定义 signal handler 替代 buffalo.Serve()
buffalo.Serve() 是封装好的阻塞式启动，不暴露底层 *http.Server 实例，无法控制 shutdown 行为。必须改用底层 API 手动接管：
Buffalo框架 1.0.1
下载
Buffalo框架 1.0.1 版本源码包下载，适合需要错误处理改进、依赖更新、render.Download 注释和 request logger 调整的 v1 项目。
func main() {
app := buffalo.New(buffalo.Options{})
// ... setup middleware, routes, etc.
srv := &http.Server{
Addr: app.Options.Addr,
Handler: app.Handler,
}
// 启动前注册 signal handler
sigChan := make(chan os.Signal, 1)
signal.Notify(sigChan, syscall.SIGINT, syscall.SIGTERM)
go func() {
if err := srv.ListenAndServe(); err != http.ErrServerClosed {
log.Fatal(err)
}
}()
<-sigChan
log.Println("shutting down gracefully...")
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
if err := srv.Shutdown(ctx); err != nil {
log.Fatal(err)
}
}
-
srv.Shutdown()会拒绝新请求、等待活跃连接完成，超时后强制关闭 - 10 秒是常见经验值，可根据业务最长请求耗时调整（如人脸特征提取可能需 5s+）
- 务必调用
app.Handler而非app.Serve()，后者内部已启动 server
结合容器健康检查与就绪探针提升平滑性
仅靠优雅 shutdown 不够：Kubernetes 在发 SIGTERM 前不会自动摘流量，需配合 livenessProbe 和 readinessProbe 避免请求打到正在关闭的服务上。
- 就绪探针（
readinessProbe）建议指向一个轻量端点，如/health/ready，服务启动完成才返回 200；shutdown 开始后立即返回 503 - 存活探针（
livenessProbe）可复用同一端点，或单独做内存/协程数检查 - 务必设置
initialDelaySeconds和periodSeconds，避免启动未完成就被判定失败
真正难的是“关得准”——既要等完最后一个推理请求，又不能卡住整个滚动更新流程。信号处理、探针节奏、超时阈值这三者得一起调，漏掉任何一个环节，平滑重启就变成纸上谈兵。
