0

0

如何确保 Go 中的 TCP 客户端协程执行完毕后再退出程序

霞舞

霞舞

发布时间:2026-01-23 14:14:19

|

222人浏览过

|

来源于php中文网

原创

如何确保 Go 中的 TCP 客户端协程执行完毕后再退出程序

go 程序中启动多个 tcp 客户端 goroutine 后,若主函数未等待它们完成便直接结束,会导致客户端逻辑(如读取响应、打印日志)被强制中断——`fmt.println("is reached")` 不输出正是此现象的典型表现。

在 Go 中,main 函数返回即代表整个程序终止,所有正在运行的 goroutine 会被立即强制停止,无论其是否执行到 defer、io.ReadFull 或后续语句。你遇到的问题根本原因正在于此:go client(...) 启动后,主 goroutine 迅速执行完循环并退出,而 client 中尚未完成的网络 I/O(尤其是阻塞在 io.ReadFull 的读取操作)和后续 fmt.Println 都被无情截断。

✅ 正确做法:使用 sync.WaitGroup 同步主协程与工作协程

WaitGroup 是 Go 标准库提供的轻量级同步原语,专为“等待一组 goroutine 完成”场景设计。你需要:

  • 在 main 中声明 wg := sync.WaitGroup{};
  • 每次 go client(...) 前调用 wg.Add(1) 增加计数;
  • 在 client 函数开头(推荐)或结尾通过 defer wg.Done() 标记完成;
  • 主循环结束后调用 wg.Wait() —— 此调用会阻塞直到所有 Done() 被调用

以下是修正后的完整结构示例:

Sora
Sora

Sora是OpenAI发布的一种文生视频AI大模型,可以根据文本指令创建现实和富有想象力的场景。

下载
func client(wg *sync.WaitGroup, servId uint16, servAddr string) {
    defer wg.Done() // 确保无论成功/失败都计数减一

    tcpAddr, err := net.ResolveTCPAddr("tcp", servAddr)
    if err != nil {
        log.Printf("resolve addr %s failed: %v", servAddr, err)
        return
    }

    conn, err := net.DialTCP("tcp", nil, tcpAddr)
    if err != nil {
        log.Printf("dial %s failed: %v", servAddr, err)
        return
    }
    defer conn.Close() // 避免连接泄漏

    _, err = conn.Write(handshake(servId, 1500))
    if err != nil {
        log.Printf("write handshake to %s failed: %v", servAddr, err)
        return
    }

    init := make([]byte, 8)
    _, err = io.ReadFull(conn, init)
    if err != nil {
        log.Printf("read init from %s failed: %v", servAddr, err)
        return
    }

    // ✅ 现在这行一定能执行并打印
    fmt.Println("is reached")
    fmt.Println("init bytes:", init)
}

func main() {
    var (
        c, startId, servId uint16
        wg                 sync.WaitGroup
    )

    for s := range config.Servers {
        for c = 0; c < config.Total_clients; c++ {
            startId = config.Server_id * config.Total_clients
            servId = startId + c
            servAddr := fmt.Sprintf("%s:%d", config.Servers[s].Host, config.Servers[s].Port)

            wg.Add(1)
            go client(&wg, servId, servAddr)
        }
    }

    wg.Wait() // ? 关键:主 goroutine 在此处阻塞,等待全部 client 完成
    fmt.Println("All clients finished.")
}

⚠️ 注意事项与最佳实践

  • 永远 defer conn.Close():避免 TCP 连接泄露,尤其在并发场景下易导致 too many open files 错误。
  • 错误处理不可省略:原始代码中 check(err) 未定义且无日志,实际应显式判断并记录错误(如上例所示),否则失败时静默退出,调试困难。
  • 不要依赖 time.Sleep 替代同步:它不可靠(可能过长或过短),且违背 Go 的并发哲学。
  • WaitGroup 必须传指针:wg.Add() 和 wg.Done() 操作的是同一实例,传值会导致副本操作无效。
  • 考虑超时控制:io.ReadFull 可能永久阻塞(如服务端不响应),建议对 conn 设置 SetReadDeadline 或改用带上下文的 net.Conn 方法(如 conn.SetReadDeadline(time.Now().Add(5 * time.Second)))。

通过正确使用 sync.WaitGroup 并辅以健壮的错误处理与资源管理,你的 TCP 客户端将稳定执行至最后一行,不再“神秘消失”。

相关专题

更多
C++ 高级模板编程与元编程
C++ 高级模板编程与元编程

本专题深入讲解 C++ 中的高级模板编程与元编程技术,涵盖模板特化、SFINAE、模板递归、类型萃取、编译时常量与计算、C++17 的折叠表达式与变长模板参数等。通过多个实际示例,帮助开发者掌握 如何利用 C++ 模板机制编写高效、可扩展的通用代码,并提升代码的灵活性与性能。

9

2026.01.23

php远程文件教程合集
php远程文件教程合集

本专题整合了php远程文件相关教程,阅读专题下面的文章了解更多详细内容。

25

2026.01.22

PHP后端开发相关内容汇总
PHP后端开发相关内容汇总

本专题整合了PHP后端开发相关内容,阅读专题下面的文章了解更多详细内容。

18

2026.01.22

php会话教程合集
php会话教程合集

本专题整合了php会话教程相关合集,阅读专题下面的文章了解更多详细内容。

19

2026.01.22

宝塔PHP8.4相关教程汇总
宝塔PHP8.4相关教程汇总

本专题整合了宝塔PHP8.4相关教程,阅读专题下面的文章了解更多详细内容。

10

2026.01.22

PHP特殊符号教程合集
PHP特殊符号教程合集

本专题整合了PHP特殊符号相关处理方法,阅读专题下面的文章了解更多详细内容。

11

2026.01.22

PHP探针相关教程合集
PHP探针相关教程合集

本专题整合了PHP探针相关教程,阅读专题下面的文章了解更多详细内容。

7

2026.01.22

菜鸟裹裹入口以及教程汇总
菜鸟裹裹入口以及教程汇总

本专题整合了菜鸟裹裹入口地址及教程分享,阅读专题下面的文章了解更多详细内容。

52

2026.01.22

Golang 性能分析与pprof调优实战
Golang 性能分析与pprof调优实战

本专题系统讲解 Golang 应用的性能分析与调优方法,重点覆盖 pprof 的使用方式,包括 CPU、内存、阻塞与 goroutine 分析,火焰图解读,常见性能瓶颈定位思路,以及在真实项目中进行针对性优化的实践技巧。通过案例讲解,帮助开发者掌握 用数据驱动的方式持续提升 Go 程序性能与稳定性。

9

2026.01.22

热门下载

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

精品课程

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

共32课时 | 4.1万人学习

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号