“too many open files”根本原因是文件描述符泄漏且进程启动时fd限制未对齐;需主动校验/proc/self/limits、强制defer关闭、设HTTP超时、避免容器ulimit错配,而非仅调大ulimit。
go 进程报 too many open files,不是“并发太高”,而是 fd 没关干净 + 启动时限制没对齐。单纯调大 ulimit -n 只能延缓崩溃,不能根治。
查清当前进程真实 fd 限制值
别信 ulimit -n 输出——它查的是 shell 的限制,不是 Go 进程的。容器里尤其容易错判。
- 进容器后执行
cat /proc/$(pidof yourapp)/limits | grep "Max open files",看Max open files行的两个数字(软限 / 硬限) - 在 Go 代码
main()开头用unix.Getrlimit(unix.RLIMIT_NOFILE, &rlim)主动读取,取rlim.Cur做校验 - 若
rlim.Cur ,直接log.Fatal("fd soft limit too low"),别等运行中崩
os.Open / os.Create 后必须 defer Close()
文件大小不影响 fd 占用,只影响内存;漏掉 Close() 是最常见泄漏源,且 GC 不会自动回收 fd。
- 所有
os.Open*调用后,强制加defer f.Close(),哪怕只读一次 - 避免在循环里反复
os.Open→io.ReadAll→ 忘关;改用os.ReadFile(内部自动开闭) - 临时文件务必用
os.CreateTemp,业务逻辑结束立即os.Remove,不等 GC
http.Server 默认配置是 fd 泄漏重灾区
没设超时的 HTTP 服务,一个慢连接就能卡住 fd 几分钟,too many open files 往往是它先爆的。
- 必须显式设置
ReadTimeout、WriteTimeout(建议 ≤30s),防止单请求长期占着 fd -
IdleTimeout设为 60–120s,比 Nginx 的keepalive_timeout小 10s,避免半开连接堆积 - Go 1.19+ 可用
MaxConns硬限总连接数,但它不区分活跃/空闲,适合突发压制
容器中 ulimit 生效必须在进程启动前固定
Go runtime 启动时只读一次 /proc/self/limits,后续容器动态调高 ulimit 它完全感知不到。
- Docker/K8s 中,
securityContext.ulimits必须作用于 PID 1 进程(即你的 Go 二进制),initContainer 无法覆盖主容器限制 - 验证方式:进容器后
ps aux | grep yourapp找到 PID,再cat /proc/看是否匹配预期/limits - 如果用
docker run --ulimit nofile=65536:65536,确保没被 entrypoint 脚本里的ulimit -n覆盖
真正难处理的不是“怎么开更多 fd”,而是“哪些 goroutine 正在持有 fd 却迟迟不释放”——比如阻塞在 syscall.Read 或卡在 os.File.Close 的 goroutine,得靠 pprof 抓 /debug/pprof/goroutine?debug=2 才能定位。











