Go compress/flate.Writer.Flush 怎样把待压缩数据及时送到接收端
来源:17golang原创
时间:2026-11-18 22:17:50 294浏览 收藏
我第一次把 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,则中途不会有同样明确的交付点。下面这张图只说明对象和数据边界,不是运行截图。

在一个逻辑消息结束处调用 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 不是越频繁越好。官方文档说明,即使没有待处理数据,调用它也会产生至少 4 字节的同步标记;如果每写几个字节就刷新,会牺牲压缩效率并增加底层写入次数。
我的实际取舍是:聊天消息、事件帧、需要低延迟反馈的协议按“完整消息”刷新;批量文件和一次性响应只在阶段边界或最后收尾;对高频小消息则先在应用层合并,再刷新一个有意义的数据块。无论哪种策略,都要把 Flush 和 Close 的错误纳入同一条错误链路。
常见问题
Flush 会不会关闭压缩流?
不会。它把当前待处理数据送到下层 writer,随后仍可继续写入;关闭动作由 Close 完成。
为什么调用了 Flush,接收端仍然没有一条完整消息?
Flush 只负责刷新压缩字节,不负责定义应用层消息边界。接收端仍需要根据长度、帧标记或协议规则拆出完整消息。
Flush 和 Close 的错误都要检查吗?
要检查。Flush 可能报告底层 writer 的写入错误,Close 还承担最终收尾;只检查其中一个会丢失失败信息。
总结
把 flate.Writer.Flush 当作“提交当前压缩片段”,把 Close 当作“结束整个压缩流”,就能解释大多数流式压缩中的延迟现象。决定刷新点时围绕逻辑消息边界设计,并为刷新频率和底层错误留出明确策略。
-
369 收藏
-
344 收藏
-
464 收藏
-
327 收藏
-
349 收藏
-
164 收藏
-
239 收藏
-
Golang · Go教程 | 13分钟前 | 标准库 · HTTP · Go教程 · Go Content-Type mime.ParseMediaType ErrInvalidMediaParameter MIME 参数117 收藏
-
Golang · Go教程 | 16分钟前 | 标准库 · 错误处理 · csv · Go教程 · Go encoding/csv io.Writer Writer.Error Writer.Flush CSV缓冲写出454 收藏
-
428 收藏
-
Golang · Go教程 | 21分钟前 | 标准库 · HTTP · 文件上传 · Go教程 · 文件上传 Go io.Copy multipart/form-data mime/multipart.Writer.CreateFormFile152 收藏
-
Golang · Go教程 | 32分钟前 | 标准库 · HTTP · url · Go教程 · Go Fragment net/url RawQuery URL.RequestURI HTTP请求目标145 收藏
-
Golang · Go教程 | 38分钟前 | 标准库 · Go教程 · Go archive/zip.FileInfoHeader zip.FileHeader Writer.CreateHeader ZIP条目167 收藏
-
297 收藏
-
148 收藏
-
171 收藏
-
Golang · Go教程 | 50分钟前 | 标准库 · Go教程 · 文件系统 · Go fs.FS os.DirFS ReadFileFS ErrNotExist fstest.MapFS io/fs.ReadFile403 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习