Go语言中sync.WaitGroup不等待的常见闭包陷阱解析

聖光之護

发布时间：2026-02-23 10:34:11

886人浏览过

来源于php中文网

原创

Go语言中sync.WaitGroup不等待的常见闭包陷阱解析

本文详解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 拥有独立副本：

Rezi.ai

一个使用 AI 自动化创建简历平台

下载

立即学习“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()
}