当前位置:首页 > 文章列表 > Golang > Go教程 > Go compress/flate.Writer.Flush 怎样把待压缩数据及时送到接收端

Go compress/flate.Writer.Flush 怎样把待压缩数据及时送到接收端

来源:17golang原创 2026-11-18 22:17:50 0浏览 收藏

我第一次把 compress/flate 接到流式传输时,最容易误判的一点是:Write 返回成功,并不代表接收端已经拿到足够的数据。flate.Writer 会先保留待压缩内容,只有在调用 Flush 时才把当前可用的数据送到底层 io.Writer。因此,消息边界需要及时可见时,正确组合是“写入一段逻辑消息后调用 Flush,全部发送完再调用 Close”。

官方文档:https://pkg.go.dev/compress/flate#Writer.Flush

Flush 是流式传输中的“提交当前片段”,Close 是压缩流的“最终收尾”。前者不结束 writer,后者会刷新并关闭它。

症状通常不是接收端读错,而是发送端还没刷新

在管道、长连接或压缩网络协议里,发送方可能连续调用几次 Write,然后等待下一次输入。接收方此时调用读取,看到的可能仍然是阻塞状态,因为压缩 writer 还没有把足够的 DEFLATE 数据交给底层 writer。

这也是我排查这类问题时先看发送侧的原因:如果把 Flush 加在每个逻辑消息的末尾,接收端能在消息边界得到当前片段;如果只在最后调用 Close,则中途不会有同样明确的交付点。下面这张图只说明对象和数据边界,不是运行截图。

flate.Writer、待压缩数据、Flush 和接收端之间的静态关系
图1:结构说明图,展示待压缩数据经 flate.Writer 刷新到下层 writer 的关系,不是截图或运行证据。

在一个逻辑消息结束处调用 Flush

Flush 会刷新当前待处理数据并等待它写入下层 writer;它不会让 flate.Writer 失效,所以后面仍然可以继续 Write。这正适合“多条消息共用一条压缩流”的场景。

package main

import (
    "compress/flate"
    "fmt"
    "io"
)

// writePacket 把一条逻辑消息写入压缩流,并在消息边界提交当前片段。
func writePacket(w *flate.Writer, text string) error {
    if _, err := w.Write([]byte(text)); err != nil {
        return fmt.Errorf("写入消息失败: %w", err)
    }
    // Flush 只刷新当前数据,不关闭压缩 writer,后续仍可继续写入。
    if err := w.Flush(); err != nil {
        return fmt.Errorf("刷新消息失败: %w", err)
    }
    return nil
}

func main() {
    reader, writer := io.Pipe()
    go func() {
        // 管道承接压缩后的字节,接收端会从 reader 持续读取。
        zw, err := flate.NewWriter(writer, flate.DefaultCompression)
        if err != nil {
            _ = writer.CloseWithError(err)
            return
        }
        if err := writePacket(zw, "第一条消息"); err != nil {
            _ = writer.CloseWithError(err)
            return
        }
        if err := writePacket(zw, "第二条消息"); err != nil {
            _ = writer.CloseWithError(err)
            return
        }
        // 所有消息发送完成后才 Close,负责最终 Flush 和流收尾。
        if err := zw.Close(); err != nil {
            _ = writer.CloseWithError(err)
            return
        }
        _ = writer.Close()
    }()

    zr := flate.NewReader(reader)
    defer zr.Close()
    buf := make([]byte, 64)
    for {
        // 这里只展示持续读取;真实协议应按自己的消息长度拆包。
        n, err := zr.Read(buf)
        if n > 0 {
            fmt.Printf("收到 %d 字节\\n", n)
        }
        if err == io.EOF {
            break
        }
        if err != nil {
            panic(err)
        }
    }
}

这个示例的关键不是用 io.Pipe,而是把刷新点放在协议认可的消息边界。真实项目中应由协议头、长度字段或帧结束标记决定边界,不能把一次底层 Read 当成一条完整消息。

为什么不能用 Close 代替中途 Flush

Close 会刷新并关闭 writer,调用后不能继续向同一个压缩 writer 写入。它适合整个响应、文件或连接发送完成的时刻,不适合“第一条消息已经完成,但后面还有消息”的场景。

我会把两个调用点分开记录:每个逻辑片段结束检查 Flush 错误;发送循环结束检查 Close 错误。若底层 writer 返回错误,Flush 会把错误返回给调用方;不要只检查 Write,否则连接断开可能延迟到收尾阶段才暴露。

Flush 与 Close 在压缩流生命周期中的职责边界
图2:生命周期关系说明图,区分消息刷新、继续写入与最终关闭,不是运行结果截图。

刷新频率怎么取舍

Flush 不是越频繁越好。官方文档说明,即使没有待处理数据,调用它也会产生至少 4 字节的同步标记;如果每写几个字节就刷新,会牺牲压缩效率并增加底层写入次数。

我的实际取舍是:聊天消息、事件帧、需要低延迟反馈的协议按“完整消息”刷新;批量文件和一次性响应只在阶段边界或最后收尾;对高频小消息则先在应用层合并,再刷新一个有意义的数据块。无论哪种策略,都要把 Flush 和 Close 的错误纳入同一条错误链路。

常见问题

Flush 会不会关闭压缩流?

不会。它把当前待处理数据送到下层 writer,随后仍可继续写入;关闭动作由 Close 完成。

为什么调用了 Flush,接收端仍然没有一条完整消息?

Flush 只负责刷新压缩字节,不负责定义应用层消息边界。接收端仍需要根据长度、帧标记或协议规则拆出完整消息。

Flush 和 Close 的错误都要检查吗?

要检查。Flush 可能报告底层 writer 的写入错误,Close 还承担最终收尾;只检查其中一个会丢失失败信息。

总结

把 flate.Writer.Flush 当作“提交当前压缩片段”,把 Close 当作“结束整个压缩流”,就能解释大多数流式压缩中的延迟现象。决定刷新点时围绕逻辑消息边界设计,并为刷新频率和底层错误留出明确策略。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Go net/url.URL.RequestURI 怎样生成请求行中的目标部分Go net/url.URL.RequestURI 怎样生成请求行中的目标部分
上一篇
Go net/url.URL.RequestURI 怎样生成请求行中的目标部分
Go mime/multipart.Writer.CreateFormFile 怎样写入上传文件字段
下一篇
Go mime/multipart.Writer.CreateFormFile 怎样写入上传文件字段
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1099次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1095次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1265次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1204次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1051次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码