登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  Golang

Gin框架高并发协程安全

时间:2026-08-20 20:00:31 386浏览 收藏

因为Gin每个请求在独立goroutine中执行,而count++非原子(读-加-写三步),并发时多个goroutine可能读到相同值并写回覆盖,导致计数丢失;应改用atomic.AddInt64(&count, 1)保证原子性。

Gin框架高并发协程安全

为什么 handler 里改全局变量会出错

问题就出在这里:Gin 处理每个请求时,都是放到各自独立的 goroutine 里跑的,而 count++ 看着只是短短一行,实际上并不是原子操作。它背后要走三步:先读当前值,再加 1,最后写回。要是两个 goroutine 恰好同时读到 100,接着各自完成加 1 并写回,结果很可能只增加了 1,而不是预期里的 2。
所以压测时就会看到很典型的现象:返回的 count 明显小于实际请求数。比如一共发了 10000 次请求,最后拿到的结果却只有 8723。

用 atomic.AddInt64 替代普通自增

这是最轻量、最安全的方案,适用于计数器、状态标志等简单整型操作。

  • count 必须声明为 int64 类型(atomicint 不提供直接支持)
  • atomic.AddInt64(&count, 1) 替代 count++,它由 CPU 指令保证不可中断
  • 读取时用 atomic.LoadInt64(&count),避免读到中间态
  • 注意:不能对 atomic 变量取地址再传给其他函数做非原子操作

什么时候该用 sync.Mutex 而不是 atomic

当你要保护的不止一个变量,或者逻辑涉及多步判断+修改(比如“如果余额 > 100 才扣款”),atomic 就不够用了。

  • 定义一个 sync.Mutex 实例,比如 var mu sync.Mutex
  • 所有访问共享数据的代码块前加 mu.Lock(),结束后立刻 mu.Unlock()
  • 别在 defer 里 unlock —— 如果 lock 失败或 panic,defer 可能不执行,导致死锁
  • 锁粒度要细:只包住真正共享的部分,不要把整个 handler 或 DB 查询包进去

context.Copy() 是异步任务的保命操作

如果你在 handler 里启 goroutine 做异步事(比如发通知、记日志),直接传入原始 c 会崩溃——因为请求一结束,Gin 就回收了这个 Context 的底层资源。

  • 必须调用 c.Copy() 得到一个可脱离生命周期的新上下文
  • 异步 goroutine 中禁止调用 c.JSON()c.Abort() 等响应相关方法,它们只对原请求有效
  • 如果异步任务需要访问请求参数,应在 Copy() 前提取并传参,而不是在 goroutine 里读 c.Param()
并发安全不是加个锁就完事,关键在识别哪些数据是多个 goroutine 共享的、哪些操作必须串行化。很多 bug 表面是“请求变慢”,实际是锁争用或原子操作漏用;而有些看似“并发问题”的日志时间戳错乱,其实只是终端输出缓冲导致的假象。
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>