go微服务中自定义钩子需在main()中依赖就绪后注册，统一用[]func()管理，启动钩子置于http.listenandserve前，关闭钩子配合signal.notify监听信号并串行执行；禁止在init()注册，避免依赖未初始化导致panic。
Go 微服务中如何注册和触发自定义钩子函数
钩子不是框架内置的“插件点”，而是你主动设计的回调入口。关键在于统一管理生命周期事件（如启动前、关闭后）并预留可注入的函数切片。不要依赖第三方库的钩子抽象，自己用 sync.Once 和 []func() 就够用。
- 启动钩子放在
main()初始化之后、http.ListenAndServe之前调用；关闭钩子需配合signal.Notify捕获os.Interrupt或syscall.SIGTERM - 钩子函数签名统一为
func()，避免参数传递复杂度；如有上下文需求，提前通过闭包捕获依赖（如数据库连接、配置实例） - 多个钩子按注册顺序执行，但不保证并发安全——若钩子间有共享状态，需自行加锁或串行化
为什么不能在 init() 里注册钩子
init() 执行时机太早，此时配置未加载、日志未初始化、依赖对象（如 *sql.DB）尚未构造，会导致 panic 或静默失败。常见错误是把数据库迁移逻辑写进 init()，结果服务启动时连不上 DB 就直接退出。
- 钩子必须在依赖就绪后注册，典型位置是
main()函数中完成配置解析、日志初始化、DB 连接池创建之后 - 如果使用 Wire 或 Dig 做依赖注入，钩子注册应作为最后一个构建步骤，确保所有 provider 已就绪
- 测试时容易忽略这点：单元测试跑
init()不报错，但集成测试一启动服务就 panic
优雅关闭时钩子执行失败的三个常见原因
服务收到 SIGTERM 后没执行关闭钩子，多半不是钩子没注册，而是主 goroutine 提前退出、信号未被监听，或钩子本身阻塞了 shutdown 流程。
- 没调用
signal.Notify(c, os.Interrupt, syscall.SIGTERM)—— Go 默认不转发信号，必须显式监听 - 关闭钩子内部调用了同步网络请求（如调用下游服务做清理），且未设超时，导致整个 shutdown 卡住；应统一用带
context.WithTimeout的 client - HTTP server 的
Shutdown()调用后立即os.Exit(0)，没等钩子执行完；正确做法是Shutdown()返回后再逐个调用钩子
如何让钩子支持条件触发和优先级
硬编码执行顺序不可靠，建议用结构体封装钩子，附带名称、阶段（pre-start / post-stop）、权重和启用开关。
- 定义类型：
type Hook struct { Name string; Phase string; Priority int; Enabled bool; Fn func() } - 注册时用
map[string][]*Hook按Phase分组，再按Priority排序执行；避免用 slice 索引隐式约定顺序 - 生产环境可通过配置项（如
hooks.db_migrate.enabled = false）动态禁用特定钩子，调试时更灵活
钩子看似简单，真正难的是控制执行边界：什么时候算“已就绪”，什么时候算“已关闭”，以及怎么让不同团队写的钩子不互相干扰。别把它当成语法糖，得当成服务生命周期契约来设计。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
