0

0

Golang使用sync.WaitGroup等待并发任务完成

P粉602998670

P粉602998670

发布时间:2026-01-07 15:54:09

|

393人浏览过

|

来源于php中文网

原创

WaitGroup 必须在启动 goroutine 前调用 Add,且次数与实际 goroutine 数严格一致;goroutine 内须用 defer wg.Done();必须传指针避免复制;它不解决数据竞争,需额外同步机制。

golang使用sync.waitgroup等待并发任务完成

WaitGroup 必须在启动 goroutine 前调用 Add

这是最常踩的坑:把 wg.Add(1) 放在 go func() { ... }() 里,或者放在 goroutine 启动之后。结果是 Wait() 可能提前返回,或 panic(如果 AddWait 返回后调用)。

正确做法是:先确定任务数,在 goroutine 启动前 调用 Add,且必须保证调用次数与实际启动的 goroutine 数严格一致。

  • Add 的参数可以是任意正整数,不一定是 1;比如批量处理时可一次 wg.Add(len(tasks))
  • 不能传负数(会 panic),也不能在 Wait() 返回后调用(会 panic)
  • 如果任务数动态生成(如从 channel 读取),需用额外变量计数并确保线程安全,或改用其他同步机制

goroutine 内必须调用 Done,且仅调用一次

Done()Add(-1) 的简写,它必须在对应 goroutine 结束前调用。漏调、多调、或在主 goroutine 中误调,都会导致 Wait() 永久阻塞或 panic。

推荐用 defer wg.Done() —— 简洁、不易遗漏、自动覆盖所有退出路径(包括 panic)。

立即学习go语言免费学习笔记(深入)”;

浚心时尚购物商城程序
浚心时尚购物商城程序

时尚购物程序v1.01、全立体设计。此系统由3个Flash动画为主线(正式版带原文件),设计更形象,网站更有吸引力。这种设计在网店系统内绝无仅有,使您的网店与众不同。2、内置音乐播放器,简单灵活的操作即可完成设置,前台任意调用。并带详细说明文件,一看就懂。合理使用此功能,可使网站更富渲染力。3、支持多图显示,每件产品最多可以上传9张图片。4、后台功能强大,销售管理,财务管理,在线支付平台管理等功能

下载
for _, url := range urls {
    wg.Add(1)
    go func(u string) {
        defer wg.Done() // ✅ 安全:无论成功/错误/panic 都执行
        resp, err := http.Get(u)
        if err != nil {
            log.Println(err)
            return
        }
        defer resp.Body.Close()
        // ...
    }(url)
}

WaitGroup 不能被复制,要传指针

sync.WaitGroup 是含 mutex 的结构体,值拷贝会导致未定义行为(常见表现:panic: sync: WaitGroup is reused before previous Wait has returned)。

所有跨 goroutine 共享的场景,都必须传 *sync.WaitGroup,而不是 sync.WaitGroup

  • 函数参数中接收 wg *sync.WaitGroup,而非 wg sync.WaitGroup
  • 闭包内引用外部 wg 变量时,确保该变量本身是地址(即已声明为 wg := &sync.WaitGroup{} 或类似)
  • 切忌在循环中对值类型 WaitGroup 做赋值或传参

WaitGroup 不解决数据竞争,只是等待完成

WaitGroup 只保证“所有 goroutine 已退出”,**不保证它们操作的数据是安全的**。如果多个 goroutine 并发读写同一变量(如 map、slice、struct 字段),仍需额外同步(sync.Mutexsync.Atomic 或 channel)。

典型反例:用 map[string]int 统计结果,goroutine 直接 results[url]++ —— 这会触发 fatal error: concurrent map writes。

  • 写 map 时加 sync.RWMutex
  • sync.Map(适合读多写少,但不支持遍历全部 key)
  • 更推荐:每个 goroutine 返回结果,主 goroutine 用 channel 收集后统一写入
WaitGroup 看似简单,但 Add/Wait/Done 的时序和所有权边界稍有偏差就会出问题;尤其要注意“谁负责 Add”“谁负责 Done”“谁持有 wg 指针”这三个责任是否清晰。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

177

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

336

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

194

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

189

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

191

2025.06.17

java学习网站推荐汇总
java学习网站推荐汇总

本专题整合了java学习网站相关内容,阅读专题下面的文章了解更多详细内容。

3

2026.01.08

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go 教程
Go 教程

共32课时 | 3.5万人学习

Go语言实战之 GraphQL
Go语言实战之 GraphQL

共10课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号