recover只能捕获当前goroutine的panic,主循环外加defer+recover无法捕获子协程panic;必须在主循环自身及每个go启动的协程内分别添加defer func(){recover()}(),且recover后应立即记录堆栈、清理资源并return或触发优雅关机。

直接在主循环外加 defer + recover() 没用——它只能捕获当前 goroutine 的 panic,而游戏服务器主循环里频繁 spawn 的协程(如连接处理、心跳、定时任务)一旦 panic,主线程照常运行,但子协程已死,状态逐渐腐烂,最终服务不可用。
主循环必须自己包一层 defer + recover
主循环函数本身要防住自身 panic,比如解包协议失败、map 并发写入、空指针解引用等。这是第一道防线,否则一次 panic 就让整个服务器停摆。
-
defer func() { if r := recover(); r != nil { log.Printf("main loop panic: %v", r) } }()必须写在 for-select 循环最外层,且要在for开始前注册 - 不能写成
defer recover()—— 那会在注册时就执行,返回nil - recover 后别继续跑逻辑,尤其别再往已损坏的全局 map 或 channel 写数据;建议记录后直接
return或触发优雅关机 - 如果主循环 panic 频繁,说明设计有硬伤(比如没做连接读写超时、没限制消息长度),光靠 recover 是掩耳盗铃
每个新 goroutine 都得独立加 recover
游戏服务器里,go handleConn(conn)、go tickGameLoop() 这类启动的协程,panic 会直接退出,且无法被主线程 recover 捕获。它们各自是独立的 panic 上下文。
- 所有
go启动的函数开头,必须显式写defer func() { recover() }() - 不要试图“统一注入”——Go 没有协程级全局钩子;Gin 的
Recovery()能工作,是因为它在每个 handler 入口都插了一次 defer - WebSocket 连接协程、TCP 连接读写协程、定时器协程,全部要单独防护;漏一个,就可能造成连接堆积或状态泄漏
- 示例:
go func() { defer func() { if r := recover(); r != nil { log.Printf("conn %p panic: %v", conn, r) } }(); handleConn(conn) }()
recover 后不能信任任何共享状态
游戏服务器重度依赖全局状态(玩家在线列表、房间表、计时器池)。一次 panic 往往意味着某个结构已被破坏(比如并发写 map 导致 hash 表损坏),recover 只是阻止崩溃,不修复数据。
文件删除恢复功能 v0.8.0:删除前自动备份文件(存至 `delete_backup/YYYYMMDDHHMM/` 目录),支持从备份中恢复、通过清单(manifest)搜索。具备 SHA256 完整性校验、路径遍历防护及工作区根目录(workspace-root)访问限制。支持自动清理 7 天 / 30 天前的备份。 **v0.8.0:新增 `workspace_cleaner` —— 支持定时清理临时文件,并在删除前自动执行备份。** **v0.7.0:`allowed_roots` 默认值
立即学习“go语言免费学习笔记(深入)”;
- recover 后禁止继续调用
close(ch)、向全局map写入、访问刚 panic 过的 struct 字段 - 不要在 recover 块里尝试“恢复玩家状态”或“重发同步包”——这些操作本身可能再次 panic
- 更安全的做法是:recover → 记录堆栈(用
debug.Stack())→ 标记该连接/房间为异常 → 触发清理逻辑(如踢出玩家、销毁房间)→ return - 堆栈获取必须在
recover()后立即执行,延迟几行就可能因其他 defer 改变栈帧
别把 recover 当熔断,该 shutdown 时就得 shutdown
高频 panic 不是偶然,而是系统已进入亚健康状态:goroutine 泄漏、内存持续上涨、连接积压。此时硬扛只会让问题雪球越滚越大。
- recover 后应检查 panic 频率(比如 1 分钟内超 5 次),达到阈值就调
srv.Shutdown(),停止接受新连接 - shutdown 超时设为 10–20 秒,太短丢玩家数据,太长拖慢滚动更新
- 不要在 recover 里调
os.Exit()—— k8s 会判定为 crashloop,反复拉起崩溃进程 - 真正的高可用不是“永不崩溃”,而是“崩溃得干净、退出得可控、重启得可靠”
最易被忽略的一点:recover 捕获的是 panic 值,不是错误原因。数组越界和空指针解引用都 panic,但前者可能只需限流,后者往往暴露严重逻辑缺陷——得靠堆栈定位,而不是只看 r 的字符串内容。


















