会诱发 Goroutine 挂起的 27 个原因
IT科技 2025-10-06 21:10:51
0
本文转载自微信公众号「脑子进煎鱼了」,挂起作者陈煎鱼。原因转载本文请联系脑子进煎鱼了公众号。挂起
大家好,原因我是挂起煎鱼。
上个月面向读者的原因提问,我们针对 goroutine 泄露中都会看到的挂起大头 runtime.gopark 函数进行了学习和了解,输出了 《Goroutine 一泄露就看到他,原因这是挂起个什么?》。
有小伙伴提到,原因虽然我们知道了 runtime.gopark 函数的挂起缘起和内在,但其实没有提到 runtime.gopark 的原因诱发原因,毕竟他会导致 Goroutine 挂起,挂起这是原因我们日常编码中需要关注的。
为此我整理了一下笔记,挂起今天这篇文章就和大家一起围观 gopark 的 27 个诱发原因。为了方便阅读,我们会根据分类进行说明。
第一部分
标识 含义 waitReasonZero 无 waitReasonGCAssistMarking GC assist marking waitReasonIOWait IO wait waitReasonZero:无正式解释,从使用情况来看。主要在 sleep 和 lock 的 2 个场景中使用。 waitReasonGCAssistMarking:GC 辅助标记阶段会使得阻塞等待。 waitReasonIOWait:IO 阻塞等待时,例如:网络请求等。云服务器提供商第二部分
标识 含义 waitReasonChanReceiveNilChan chan receive (nil chan) waitReasonChanSendNilChan chan send (nil chan) waitReasonChanReceiveNilChan:对未初始化的 channel 进行读操作。 waitReasonChanSendNilChan:对未初始化的 channel 进行写操作。第三部分
标识 含义 waitReasonDumpingHeap dumping heap waitReasonGarbageCollection garbage collection waitReasonGarbageCollectionScan garbage collection scan waitReasonDumpingHeap:对 Go Heap 堆 dump 时,这个的使用场景仅在 runtime.debug 时,也就是常见的 pprof 这一类采集时阻塞。 waitReasonGarbageCollection:在垃圾回收时,主要场景是 GC 标记终止(GC Mark Termination)阶段时触发。 waitReasonGarbageCollectionScan:在垃圾回收扫描时,主要场景是 GC 标记(GC Mark)扫描 Root 阶段时触发。第四部分
标识 含义 waitReasonPanicWait panicwait waitReasonSelect select waitReasonSelectNoCases select (no cases) waitReasonPanicWait:在 main goroutine 发生 panic 时,会触发。 waitReasonSelect:在调用关键字 select 时会触发。 waitReasonSelectNoCases:在调用关键字 select 时,若一个 case 都没有,会直接触发。第五部分
标识 含义 waitReasonGCAssistWait GC assist wait waitReasonGCSweepWait GC sweep wait waitReasonGCScavengeWait GC scavenge wait waitReasonGCAssistWait:GC 辅助标记阶段中的结束行为,会触发。 waitReasonGCSweepWait:GC 清扫阶段中的结束行为,会触发。 waitReasonGCScavengeWait:GC scavenge 阶段的结束行为,会触发。GC Scavenge 主要是新空间的服务器租用垃圾回收,是一种经常运行、快速的 GC,负责从新空间中清理较小的对象。第六部分
标识 含义 waitReasonChanReceive chan receive waitReasonChanSend chan send waitReasonFinalizerWait finalizer wait waitReasonChanReceive:在 channel 进行读操作,会触发。 waitReasonChanSend:在 channel 进行写操作,会触发。 waitReasonFinalizerWait:在 finalizer 结束的阶段,会触发。在 Go 程序中,可以通过调用 runtime.SetFinalizer 函数来为一个对象设置一个终结者函数。这个行为对应着结束阶段造成的回收。第七部分
标识 含义 waitReasonForceGCIdle force gc (idle) waitReasonSemacquire semacquire waitReasonSleep sleep waitReasonForceGCIdle:强制 GC(空闲时间)结束时,会触发。 waitReasonSemacquire:信号量处理结束时,会触发。 waitReasonSleep:经典的 sleep 行为,会触发。第八部分
标识 含义 waitReasonSyncCondWait sync.Cond.Wait waitReasonTimerGoroutineIdle timer goroutine (idle) waitReasonTraceReaderBlocked trace reader (blocked) waitReasonSyncCondWait:结合 sync.Cond 用法能知道,是在调用 sync.Wait 方法时所触发。 waitReasonTimerGoroutineIdle:与 Timer 相关,在没有定时器需要执行任务时,会触发。 waitReasonTraceReaderBlocked:与 Trace 相关,ReadTrace会返回二进制跟踪数据,云南idc服务商将会阻塞直到数据可用。第九部分
标识 含义 waitReasonWaitForGCCycle wait for GC cycle waitReasonGCWorkerIdle GC worker (idle) waitReasonPreempted preempted waitReasonDebugCall debug call waitReasonWaitForGCCycle:等待 GC 周期,会休眠造成阻塞。 waitReasonGCWorkerIdle:GC Worker 空闲时,会休眠造成阻塞。 waitReasonPreempted:发生循环调用抢占时,会会休眠等待调度。 waitReasonDebugCall:调用 GODEBUG 时,会触发。总结
今天这篇文章是对开头 runtime.gopark 函数的详解文章的一个补充,我们能够对此了解到其诱发的因素。
主要场景为:
通道(Channel)。 垃圾回收(GC)。 休眠(Sleep)。 锁等待(Lock)。 抢占(Preempted)。 IO 阻塞(IO Wait) 其他,例如:panic、finalizer、select 等。我们可以根据这些特性,去拆解可能会造成阻塞的原因。其实也就没必要记了,他们会导致阻塞肯定是由于存在影响控制流的因素,才会导致 gopark 的调用。