e.Static()中断连接因其底层用http.FileServer，不支持Range请求、无流式控制、超时激进；正确做法是用c.File()，它调用http.ServeContent，支持断点续传和拖拽播放。
为什么 e.Static() 在大文件场景下会中断连接
Echo 的 e.Static() 底层直接包装 http.FileServer，不处理 Range 请求、无流式分块控制、默认超时策略激进。50MB 视频在弱网或高延迟环境下常触发 TCP 连接重置，浏览器报 ERR_CONNECTION_RESET 或播放卡死——这不是前端问题，是服务端未按 HTTP 流式语义响应。
用 c.File() 实现安全可控的单文件流式分发
c.File() 是上下文级方法，基于 http.ServeFile + io.Copy，天然支持 Range、If-Modified-Since 和 ETag，内存占用恒定（不加载全文件），适合头像、PDF、视频等任意大小静态资源。
- 必须做路径校验：防止
../etc/passwd类遍历攻击，用strings.Contains(filename, "..") || strings.HasPrefix(filename, ".")拦截 - 推荐显式拼接路径：
filepath.Join("uploads", name)，而非字符串拼接 - 若文件无扩展名，Echo v4.12+ 会 fallback 到
text/plain，可提前用mime.TypeByExtension设置c.Response().Header().Set("Content-Type", ...) - 错误要区分处理：
os.IsNotExist(err)返回 404，其他 err 建议 500 并记录日志
如何让 /static/ 路径只服务白名单后缀文件
全局挂载 e.Static("/static", "./public") 不安全，且无法过滤类型；e.File("/static/:filename", "./public/:filename") 又太松（仍可能绕过）。更稳妥的是自定义 http.FileSystem：
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
type SafeFS struct {
fs http.FileSystem
}
func (s SafeFS) Open(name string) (http.File, error) {
ext := strings.ToLower(filepath.Ext(name))
if !slices.Contains([]string{".jpg", ".jpeg", ".png", ".gif", ".pdf", ".mp4"}, ext) {
return nil, os.ErrNotExist
}
return s.fs.Open(name)
}
e.GET("/static/*", echo.WrapHandler(http.StripPrefix("/static", http.FileServer(SafeFS{http.Dir("./public")}))))
注意：http.Dir 的路径必须是绝对路径（可用 filepath.Abs("./public") 转换），否则 Open 可能静默失败。
上传后文件怎么立刻被前端访问到
很多人调用完 c.FormFile() 就以为“上传完成”，其实只是拿到 *multipart.FileHeader，还没写入磁盘；而即使写入了，Echo 也不会自动把 ./uploads 映射为 URL。两个动作必须手动串联：
- 接收阶段：调用
fileHeader.Open()→io.Copy(dst, src)→ 校验fileHeader.Size和path.Base(fileHeader.Filename) - 服务阶段：不能只靠
e.Static("/uploads", "./uploads")，要改用e.GET("/uploads/:name", handler)+c.File()，并加路径白名单校验 - 权限陷阱：Linux 下 Go 进程可能无权写入
./uploads，需提前os.MkdirAll("./uploads", 0755)，Windows 下注意反斜杠转义
最易忽略的一点：开发时用 localhost:8080/uploads/test.jpg 能打开，上线后 Nginx 反代没配 location /uploads/ 透传，结果全是 404——静态资源分发从来不只是框架的事，得盯住整个请求链路。
