Golang Gin后端API容器内存涨至8GiB触发重启，求排查原因

我有一个基于Golang Gin框架的后端API Docker容器，内存限制设置为8GiB。平均运行1天后，内存占用会攀升至8GiB，导致容器重启。当前存在内存持续上涨的情况，达到限制阈值后必须重启。

常见原因及排查方向 #

• 资源未正确释放
  数据库连接、HTTP客户端请求、文件句柄、WebSocket连接等资源未调用Close()，或未用defer确保释放。比如Gin请求处理中，数据库连接用完没放回连接池，或者连接池最大连接数配置过高，空闲连接长期占用内存。

• goroutine泄漏
  启动的goroutine因通道阻塞、等待未触发的信号、错误处理疏漏等无法退出，数量持续累积。每个goroutine默认占用2KB栈内存（可动态扩容），大量泄漏会快速耗尽内存。比如中间件里启动的goroutine未处理退出条件。

• 无限制的缓存/全局变量
  用map做缓存但未设置过期淘汰机制，或全局切片、结构体持续追加元素不清理，随着请求量增长，内存被持续占用无法回收。

• 第三方库内存泄漏
  依赖的数据库驱动、消息队列客户端等第三方SDK存在内存泄漏问题，可排查依赖包的版本或官方已知issue。

• Go GC配置或版本问题

  • Go 1.12之前的版本无法正确感知Docker容器内存限制，会按宿主机内存计算GC阈值，导致内存占用超标，建议升级到Go 1.12+。
  • 默认GC触发阈值（GOGC=100，内存增长100%时触发）可能不够频繁，可尝试设置GOGC=50让GC更积极。

• 业务逻辑中的大对象累积
  每次请求都创建大切片、结构体，且这些对象被全局变量等长期引用，无法被GC回收；或者日志、调试信息缓存到内存未及时写入磁盘，导致内存占用上升。

实用排查工具 #

• 集成Gin的pprof端点，用go tool pprof分析内存分配、goroutine数量，定位泄漏点。
• 用docker stats实时监控容器内存变化，docker logs查看重启前的异常日志。
• 设置GODEBUG=gctrace=1启动容器，查看GC触发频率和回收量，判断GC是否正常工作。

内容的提问来源于stack exchange，提问作者Mevo