0

0

Go: 解决 goroutine 死锁问题——正确等待所有并发任务完成

碧海醫心

碧海醫心

发布时间:2025-12-29 19:51:08

|

818人浏览过

|

来源于php中文网

原创

Go: 解决 goroutine 死锁问题——正确等待所有并发任务完成

本文详解 go 中 “all goroutines are asleep - deadlock” 错误的成因与修复,聚焦于无限 `select` 循环导致主 goroutine 永久阻塞的问题,并提供安全、可预测的通道消费方案。

你的程序崩溃并输出 fatal error: all goroutines are asleep - deadlock!,根本原因在于:主 goroutine 在一个无退出条件的 for { select { ... } } 无限循环中永久阻塞,而所有工作 goroutine 已全部执行完毕并退出,导致整个程序无任何活跃 goroutine 可运行——即死锁

具体分析如下:

  • 你启动了 5 个 goroutine(对应 file_names 的 5 个文件),每个 goroutine 调用 proccesFileName,并在处理完所有缩略图(6 张)后,向 c 或 ce 发送若干消息(共约 30 条);
  • 然而,主 goroutine 的 for { select { ... } } 没有终止逻辑:它会一直等待从 c 或 ce 接收消息,但一旦所有工作 goroutine 执行完毕、通道不再有新数据写入,且你又未关闭通道,select 就永远阻塞;
  • 更严重的是:proccesFileName 中存在一个隐蔽 bug —— defer file.Close() 和 defer out.Close() 的位置错误(defer 在函数开头定义,但 file/out 可能为 nil,且 defer 不会在 return 后立即执行),但这不是死锁主因;真正致命的是主循环无法感知“所有任务已完成”这一状态

✅ 正确做法:明确知道需接收的消息总数,并据此控制循环次数。由于每个文件生成 6 张缩略图(scales 长度为 6),5 个文件共发送最多 5 × 6 = 30 条成功消息(或若干错误),因此可精确循环 30 次:

// 替换原无限循环
for i := 0; i < len(file_names)*len([]float32{1.0, 0.8, 0.6, 0.5, 0.25, 0.01}); i++ {
    select {
    case str := <-c:
        fmt.Println(str)
    case err := <-ce:
        fmt.Println("ERROR:", err)
    }
}

更健壮、推荐的方案是使用 sync.WaitGroup + 关闭通道,实现优雅等待与信号通知:

Figma
Figma

Figma 是一款基于云端的 UI 设计工具,可以在线进行产品原型、设计、评审、交付等工作。

下载
func main() {
    runtime.GOMAXPROCS(4)

    file_names := make([]string, 5)
    for i := 1; i < 6; i++ {
        file_names[i-1] = fmt.Sprintf("%v", i)
    }

    c := make(chan string, 32)   // 建议设缓冲,避免 sender 阻塞
    ce := make(chan error, 8)

    var wg sync.WaitGroup
    wg.Add(len(file_names))

    for _, filename := range file_names {
        go func(fn string) {
            defer wg.Done()
            proccesFileName(fn, c, ce)
        }(filename) // 注意:必须传参,避免闭包捕获循环变量
    }

    // 启动 goroutine 关闭通道(在所有 worker 完成后)
    go func() {
        wg.Wait()
        close(c)
        close(ce)
    }()

    // 安全消费:range channel 自动在关闭后退出
    for str := range c {
        fmt.Println(str)
    }
    for err := range ce {
        fmt.Println("ERROR:", err)
    }
}

⚠️ 关键注意事项:

  • 闭包陷阱:原代码 go func() { proccesFileName(filename, ...) }() 中 filename 是循环变量,所有 goroutine 共享同一地址,最终可能全处理最后一个值。务必通过 go func(fn string){...}(filename) 显式传参。
  • 通道未关闭 + 无限等待 = 必然死锁:range 或 select 永不退出,除非通道被关闭。
  • defer 位置错误:defer file.Close() 应在 os.Open 成功后立即调用(如 if err == nil { defer file.Close() }),否则 file 为 nil 时 defer file.Close() 会 panic。
  • 缓冲通道提升性能:为 c/ce 设置合理缓冲(如 make(chan string, 32)),避免 sender 因 receiver 暂未读取而阻塞。

总结:Go 的死锁检测非常严格。避免 all goroutines are asleep 的核心原则是——确保至少有一个 goroutine 始终处于可运行状态,或通过关闭通道+有限循环/range 明确结束等待。优先使用 sync.WaitGroup 协调任务生命周期,并配合已关闭的通道进行消费,这是生产环境最可靠、最易维护的模式。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

311

2023.08.02

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

709

2023.08.22

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

184

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

260

2023.10.25

go语言闭包相关教程大全
go语言闭包相关教程大全

本专题整合了go语言闭包相关数据,阅读专题下面的文章了解更多相关内容。

130

2025.07.29

Golang 命令行工具(CLI)开发实战
Golang 命令行工具(CLI)开发实战

本专题系统讲解 Golang 在命令行工具(CLI)开发中的实战应用,内容涵盖参数解析、子命令设计、配置文件读取、日志输出、错误处理、跨平台编译以及常用CLI库(如 Cobra、Viper)的使用方法。通过完整案例,帮助学习者掌握 使用 Go 构建专业级命令行工具与开发辅助程序的能力。

1

2025.12.29

ip地址修改教程大全
ip地址修改教程大全

本专题整合了ip地址修改教程大全,阅读下面的文章自行寻找合适的解决教程。

162

2025.12.26

压缩文件加密教程汇总
压缩文件加密教程汇总

本专题整合了压缩文件加密教程,阅读专题下面的文章了解更多详细教程。

52

2025.12.26

wifi无ip分配
wifi无ip分配

本专题整合了wifi无ip分配相关教程,阅读专题下面的文章了解更多详细教程。

108

2025.12.26

热门下载

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

精品课程

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

共32课时 | 3.1万人学习

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

共10课时 | 0.8万人学习

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

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