本文详解go中使用sync.waitgroup时goroutine无法正确等待的根本原因——循环变量捕获问题，并提供两种安全、规范的修复方案，附可运行示例与关键注意事项。
本文详解go中使用sync.waitgroup时goroutine无法正确等待的根本原因——循环变量捕获问题，并提供两种安全、规范的修复方案，附可运行示例与关键注意事项。
在Go并发编程中，sync.WaitGroup 是协调多个 goroutine 执行完成的常用工具。但初学者常遇到一个典型问题：调用 wg.Wait() 后程序立即返回，打印结果全为 0 或空值，看似“未等待”——实则并非 WaitGroup 失效，而是goroutine 捕获了循环变量的地址而非值，导致所有 goroutine 共享同一个变量实例。
以下是最具代表性的错误写法：
func printSize(listOfUrls []string) {
var wg sync.WaitGroup
wg.Add(len(listOfUrls))
for _, myurl := range listOfUrls {
go func() { // ❌ 错误：匿名函数闭包捕获的是外部变量 myurl 的引用
body := getUrlBody(myurl) // 所有 goroutine 实际读取的是循环结束后的最终值（或中间脏值）
fmt.Println(len(body))
wg.Done()
}()
}
wg.Wait() // 可能过早返回：因 goroutine 未真正处理预期 URL
}该问题源于 Go 中 for 循环变量复用机制：myurl 在每次迭代中被重用内存地址，而非创建新变量。当 goroutine 延迟执行时（如 getUrlBody 耗时），它们读取的已是循环末尾的 myurl 值（甚至可能是空字符串或越界残留），造成逻辑错乱。
✅ 正确解决方案（二选一）
方案一：将循环变量作为参数传入闭包（推荐）
显式传递当前迭代值，确保每个 goroutine 拥有独立副本：
立即学习“go语言免费学习笔记（深入）”；
func printSize(listOfUrls []string) {
var wg sync.WaitGroup
wg.Add(len(listOfUrls))
for _, myurl := range listOfUrls {
go func(url string) { // ✅ 参数 url 是独立拷贝
body := getUrlBody(url)
fmt.Printf("URL: %s → Body length: %d\n", url, len(body))
wg.Done()
}(myurl) // 立即传入当前 myurl 值
}
wg.Wait()
}方案二：在循环体内声明新变量（语义清晰）
通过短变量声明 myurl := myurl 创建局部副本，避免闭包捕获外层变量：
func printSize(listOfUrls []string) {
var wg sync.WaitGroup
wg.Add(len(listOfUrls))
for _, myurl := range listOfUrls {
myurl := myurl // ✅ 创建同名但独立作用域的局部变量
go func() {
body := getUrlBody(myurl) // 此处 myurl 是安全的副本
fmt.Printf("URL: %s → Body length: %d\n", myurl, len(body))
wg.Done()
}()
}
wg.Wait()
}⚠️ 关键注意事项
- 永远不要在循环中直接闭包引用 for 变量（包括 range 的索引和元素）；
- 使用 go vet 工具可检测此类问题（Go 1.22+ 默认启用）；
- 若需传递多个参数，统一通过闭包参数传入，避免混合使用局部声明与闭包捕获；
- getUrlBody 应具备超时控制（如 http.Client.Timeout），防止单个请求阻塞整个 WaitGroup；
- wg.Add() 必须在 goroutine 启动前调用，且数量必须精确匹配，否则 Wait() 可能死锁或 panic。
掌握这一模式，不仅能解决 WaitGroup “不等待”的表象问题，更能深入理解 Go 闭包与变量作用域的本质，写出健壮、可维护的并发代码。
