Echo 框架上传大文件需显式配置 echo.MultipartFormMaxMemory 和 echo.MaxRequestBodySize，否则因默认 4MB 内存限制和请求体大小限制触发 400/500 错误；c.FormFile() 返回 nil 或报 "http: request body too large" 即由此导致。
直接说结论：Echo 框架上传视频等大文件，不配 echo.MultipartFormMaxMemory 和 echo.MaxRequestBodySize 就会 400 或 500 错误，不是代码写错，是默认限制太严。
为什么 c.FormFile() 突然返回 nil 或报错？
常见现象是：前端用 multipart/form-data 提交了文件，但后端 c.FormFile("video") 返回 err != nil，错误信息类似 "http: request body too large" 或空指针 panic。
根本原因有两个：
- Echo 默认只允许最多 4MB 的内存缓存 multipart 数据（
echo.MultipartFormMaxMemory = 4 ），超限就拒绝解析整个表单 - HTTP 请求体总大小还受
echo.MaxRequestBodySize限制（默认 4MB），它在echo.New()后必须显式设置，否则大视频直接被中间件拦截 - 这两个值不是“建议”，是硬性闸门；哪怕你只读
file.Size不读内容，也得先过这关
如何安全配置上传参数？
必须在 e := echo.New() 之后、注册路由之前设置，顺序错就无效：
e.MaxRequestBodySize = 1024 * 1024 * 512 // 512MB
e.Server.ReadTimeout = 30 * time.Second
e.Server.WriteTimeout = 60 * time.Second
<p>// 设置 multipart 解析内存上限（影响 file.Open() 能否成功）
e.HTTPErrorHandler = func(err error, c echo.Context) {
if he, ok := err.(*echo.HTTPError); ok && he.Code == http.StatusRequestEntityTooLarge {
_ = c.String(http.StatusRequestEntityTooLarge, "文件太大，请控制在 512MB 以内")
return
}
echo.DefaultHTTPErrorHandler(err, c)
}
注意：MultipartFormMaxMemory 是全局静态变量，需在 import 后立即改：
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
import (
"github.com/labstack/echo/v4"
)
func init() {
echo.MultipartFormMaxMemory = 1024 * 1024 * 128 // 128MB
}
file.Open() 后怎么避免 OOM？
调用 file.Open() 得到的是一个 io.ReadCloser，但很多人直接 io.ReadAll() 或用 buf := make([]byte, file.Size) —— 这会让整个视频加载进内存，1GB 视频直接崩进程。
正确做法是流式处理：
- 用
io.Copy()直接写入磁盘或对象存储，不经过内存中转 - 如果要校验（如计算 SHA256），用
hash.Hash+io.Copy组合，边读边算 - 永远加
defer src.Close()，否则文件句柄泄漏，Linux 下撑不过几百次上传 - 别信
file.Size—— 它来自 header，可被伪造；真实大小以io.Copy实际写入为准
部署时最易忽略的系统层限制
Go 应用跑通了，上线 Nginx 或 Cloudflare 后又 413，这不是 Echo 的问题：
- Nginx 需配
client_max_body_size 512m;，且要放在http、server、location三处（漏一处就失效） - Cloudflare 免费版硬限 100MB，不管你的 Echo 设多大都没用
- Linux
ulimit -n太低会导致并发上传时 “too many open files”，尤其用os.Create()频繁创建文件时
真正卡住线上服务的，往往不是 Go 代码，而是这些边界没对齐。上传路径上每个环节（浏览器 → CDN → 反代 → Go 进程 → OS）都得单独确认容量和超时。
