Echo框架怎么实现单文件上传-Golang-PHP中文网

直接调用 c.formfile("file") 获取 *multipart.fileheader，需确保 name 属性一致，再通过 fh.open() 读取数据流并校验、安全命名后保存。

echo框架怎么实现单文件上传

如何用 `echo.FormFile()` 获取上传的单个文件

直接调用 c.FormFile("file") 即可拿到 *multipart.FileHeader，这是 Echo 处理单文件上传最轻量、最常用的方式。它底层封装了 http.Request.ParseMultipartForm，但自动处理了大小限制和错误提前返回。

注意字段名（如 "file"）必须和前端 <input type="file" name="file"> 的 name 属性严格一致，否则返回 nil, echo.ErrNotFound。

必须在路由 handler 中调用，不能在中间件里提前读取 Body，否则后续 FormFile 会失败
默认只解析前 32MB 的 multipart 数据（由 echo.MaxMemory 控制），超限会报 http: request body too large
如果前端传了多个同名 file 字段，FormFile 只返回第一个；要全量获取请改用 c.MultipartForm()

保存文件前必须手动打开 `FileHeader.Open()`

FormFile() 返回的只是元信息（文件名、大小、头信息），不包含实际数据流。真正读取内容要靠 fh.Open() —— 它返回一个 multipart.File，本质是 io.ReadCloser。

常见错误是跳过这步，直接对 fh 做 os.Create 写空文件，或者误以为 fh.Size 是可读字节数（其实只是声明大小，未必真实）。

务必用 defer f.Close() 释放句柄，否则并发高时可能触发 too many open files
f.Read() 或 io.Copy() 才真正触发数据读取；若上传中断，Read() 会返回 io.ErrUnexpectedEOF
别用 fh.Size 做唯一校验——攻击者可伪造该值，应边读边累加并对比最终长度

怎么安全地生成存储路径和防止覆盖

用户传的 fh.Filename 是不可信的，含路径遍历（如 ../../etc/passwd）、空字节、控制字符等风险。Echo 不做自动净化，必须自己处理。

Echo框架 5.1.0

Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。

下载

推荐组合使用 filepath.Base() + 随机前缀 + 时间戳，再白名单校验扩展名：

ext := strings.ToLower(filepath.Ext(fh.Filename))
if !slices.Contains([]string{".jpg", ".png", ".pdf"}, ext) {
    return echo.NewHTTPError(http.StatusBadRequest, "unsupported file type")
}
filename := fmt.Sprintf("%d_%s%s", time.Now().UnixMilli(), uuid.NewString()[:8], ext)
dst, _ := os.Create(filepath.Join("/upload", filename))