应使用 filepath.Base(file.Filename) 提取原始文件名并结合服务端生成唯一标识（如 UUID）构造安全路径，再通过 os.Create + io.Copy 手动保存；需校验 MIME 类型与扩展名双保险，注意临时文件清理和目录穿越防护。
echo.FileHeader.Name 是原始文件名，别直接用
很多人一上来就写 file.Filename 或 file.Header.Get("filename") 拿名字，结果发现中文乱码、带路径、有空格、甚至被客户端伪造。真实场景中，file.Filename 是客户端传来的任意字符串，不可信，也不适合作为服务器存储名。
真正该用的是 file.Filename 的解析结果（如去掉路径）+ 服务端生成的唯一标识。Echo 本身不提供自动重命名逻辑，得你自己在 Save 前构造目标路径。
用 io.Copy + os.Create 自定义保存路径最可控
官方推荐的 file.Save 方法底层也是调用 os.Create，但封装后反而限制了命名自由度。直接手动处理更灵活：
- 先用
filepath.Base(file.Filename)提取干净的原始文件名（去掉可能的C:\fakepath\或/etc/passwd） - 用
uuid.New().String()或time.Now().UnixNano()生成前缀 - 拼出完整路径：
path.Join(uploadDir, fmt.Sprintf("%s_%s", uuid, cleanName)) - 用
os.Create创建文件，再用io.Copy写入
这样你可以精确控制大小写、分隔符、是否保留扩展名、是否加哈希等——比如强制小写后缀：strings.ToLower(filepath.Ext(cleanName))。
Echo框架 5.1.0
下载
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
注意 multipart.MaxMemory 和临时文件残留
如果上传文件超过 echo.MultipartFormMaxMemory（默认 32MB），Echo 会把文件写入磁盘临时文件，file.Open() 返回的是一个 *os.File，此时你必须确保读完后调用 file.Close()，否则临时文件不会自动清理，磁盘会悄悄占满。
常见坑点：
- 没 defer
file.Close()，导致句柄泄漏 - 用
file.Size判断大小，但大文件实际是临时文件，Size可能不准（尤其 Windows） - 自定义命名时用了
file.Filename中的路径分隔符（如../），造成目录穿越
验证扩展名必须用白名单 + MIME 检测双保险
只靠 filepath.Ext 过滤后缀是危险的。攻击者可以上传 shell.php.jpg 绕过检查。正确做法：
- 先读取文件头几个字节，用
http.DetectContentType或mimesniffer库检测真实 MIME 类型 - 和白名单比对：
image/jpeg、image/png等，拒绝text/plain或空类型 - 再结合扩展名做二次校验，两者都通过才允许保存
命名时建议统一用安全后缀，比如不管原始名是 .JPG 还是 .jpeg，都转成 .jpg，避免后续 Nginx 或 CDN 因大小写问题 404。
