静态资源访问用e.static()或middleware.static()，上传文件必须用c.formfile()+file.open()+io.copy()手动处理；e.static()仅单向响应get请求，不解析multipart/form-data，无法接收上传。
直接说结论：静态资源访问用 e.Static() 或 middleware.Static()，上传文件必须用 c.FormFile() + file.Open() + io.Copy() 手动处理，不能靠静态服务机制。
为什么 e.Static() 不能用来“接收”上传文件
e.Static() 是单向的——只负责把服务器上的文件发给浏览器，它不处理任何 HTTP POST / multipart/form-data 请求。你配了 e.Static("/static", "public")，浏览器能 GET 到 /static/logo.png，但绝不会因此获得一个“上传入口”。上传是客户端主动发数据，需要显式路由 + handler 解析表单。
- 常见错误现象：
405 Method Not Allowed或根本收不到文件，因为没定义 POST 路由 - 混淆点：有人以为把上传目录挂成静态路径（如
e.Static("/uploads", "uploads")）就能“自动接收”，这是完全错误的理解 - 本质区别：
e.Static()底层调用http.FileServer；上传必须走c.FormFile()解析multipart.Reader
正确配置静态资源访问（JS/CSS/图片等）
用 e.Static() 最简，适合前端资源托管；需目录浏览或自定义行为时换 middleware.StaticWithConfig()。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
-
e.Static("/static", "public")：访问/static/main.js→ 读取public/main.js，自动设Content-Type，但不支持目录列表 - 要开启目录浏览（调试用）：
e.Use(middleware.StaticWithConfig(middleware.StaticConfig{Root: "public", Browse: true})) - 注意路径安全：Static 中间件默认不做路径遍历过滤，确保
Root是绝对路径或受控子目录（如用filepath.Join("public", ...)拼接时需校验） - MIME 类型依赖文件扩展名，确保上传后的文件后缀正确（比如
avatar.jpg而不是avatar）
上传文件的最小可靠写法（含校验与保存）
必须手动解析表单、校验、流式保存，避免内存爆炸。不要用 c.SaveUploadedFile()（v4.12+ 已弃用且不校验）。
- 定义 POST 路由：
e.POST("/upload", uploadHandler) - 在 handler 中调用
file, err := c.FormFile("file")（"file"是 HTML 表单中<input type="file" name="file">的name） - 强制校验文件名：
if strings.Contains(file.Filename, "..") || strings.HasPrefix(file.Filename, "/")→ 返回echo.NewHTTPError(http.StatusBadRequest) - 打开并保存：
src, _ := file.Open(); dst, _ := os.Create(filepath.Join("uploads", file.Filename)); io.Copy(dst, src) - 务必
defer src.Close()和defer dst.Close()，否则句柄泄漏
上传大文件（如视频）的额外注意事项
单纯能传不等于能播。上传后的文件若要被浏览器直接播放（如 <video src="/uploads/demo.mp4"></video>），必须满足两点：
- 静态服务不能用
e.Static()，得换成c.File()（见知识库中“服务大视频文件”部分），否则拖动进度条失败 - 上传时建议限制大小：
c.Request().MultipartReader()前先检查c.Request().ContentLength，超限直接返回413 Payload Too Large - 如果前端用分片上传（如 tus），那就完全绕过
FormFile，改用c.Request().Body流式接收，再拼接
真正容易被忽略的是：上传和提供服务是两个独立环节，前者重校验与稳定性，后者重流式与 HTTP 头——混用 Static 和 FormFile 看似省事，实际埋下播放中断、路径遍历、OOM 的坑。
