Iris 框架需用 excelize 手动构建 Excel 并直写 ResponseWriter,设正确 Content-Type 与 Content-Disposition,禁用默认 Sheet1,流式写入防 OOM,多 sheet 不支持 Stream 模式。

Iris 框架本身不内置 Excel 导出能力,必须依赖第三方库(如 github.com/360EntSecGroup-Skylar/excelize)手动构建 .xlsx 文件并写入 HTTP 响应流。直接调用 ResponseWriter 返回二进制内容即可,无需临时文件或中间存储。
为什么不能用 Spring Boot 那套 @ResponseBody + ResponseEntity?
Iris 是 Go 语言框架,没有 Java 的反射式响应封装机制。它的 Context 接口提供的是底层 HTTP 控制权,所有导出逻辑需显式设置 Header、Content-Type 和写入字节流。
-
Content-Type必须设为"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",否则浏览器可能拒绝下载或误判为 ZIP - 必须设置
Content-DispositionHeader,例如:attachment; filename="report.xlsx",否则文件名丢失或被当作 inline 内容渲染 - 不能在写入前调用
ctx.StatusCode()或其他可能触发 header flush 的操作,否则会 panic:“header already written”
用 excelize 生成多 sheet 报表的最小可行代码
假设你有两个 []map[string]interface{} 数据切片,要分别写入 “用户汇总” 和 “订单明细” 两个 sheet:
func exportExcel(ctx iris.Context) {
f := excelize.NewFile()
// 创建 sheet
f.NewSheet("用户汇总")
f.NewSheet("订单明细")
// 写入第一张表(带表头)
headers1 := []string{"ID", "Name", "Email"}
f.SetSheetRow("用户汇总", "A1", &headers1)
for i, u := range users {
row := []interface{}{u.ID, u.Name, u.Email}
f.SetSheetRow("用户汇总", fmt.Sprintf("A%d", i+2), &row)
}
// 写入第二张表
headers2 := []string{"OrderID", "Amount", "Status"}
f.SetSheetRow("订单明细", "A1", &headers2)
for i, o := range orders {
row := []interface{}{o.ID, o.Amount, o.Status}
f.SetSheetRow("订单明细", fmt.Sprintf("A%d", i+2), &row)
}
// 删除默认的 Sheet1
f.DeleteSheet("Sheet1")
// 设置响应头
ctx.ResponseWriter().Header().Set("Content-Type", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
ctx.ResponseWriter().Header().Set("Content-Disposition", `attachment; filename="report.xlsx"`)
// 直接写入 response body
if err := f.Write(ctx.ResponseWriter()); err != nil {
ctx.StatusCode(500)
ctx.WriteString("export failed: " + err.Error())
return
}
}
- 注意
f.Write()接收的是io.Writer,ctx.ResponseWriter()满足该接口,避免内存拷贝 - 不要用
f.Bytes()全量加载到内存再 write,大数据量时易 OOM;f.Write()是流式写入 - sheet 名不能含
:、\、/、?、*、[、],否则f.NewSheet()会静默失败或后续写入报错
导出大文件时内存和超时怎么控?
超过 10 万行数据时,excelize 默认行为是全内存建模,容易触发 GC 压力或超时。关键控制点:
- 启用流式写入模式:
f = excelize.NewFile(); f.Stream = true(仅支持单 sheet 场景,多 sheet 不适用) - 对超长文本列预设列宽:
f.SetColWidth("用户汇总", "C", "C", 50),避免自动计算拖慢速度 - 禁用样式缓存:
f.StyleSheet = nil(如果不需要格式),可减少 30%+ 内存占用 - 在 Iris 路由注册时加超时控制:
app.Get("/export", exportExcel).Before(iris.LimitRequestBody(50,防恶意大请求
真正难处理的是并发导出——excelize.File 实例不是 goroutine 安全的,每个请求必须新建实例,不能复用或池化。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











