解析失败主因是未调用 r.parsemultipartform 或参数不当；go 默认不自动解析 multipart/form-data，必须显式调用该方法且在访问 r.formfile 或 r.formvalue 前完成，否则字段为空。
上传文件时为什么 multipart/form-data 解析失败？
常见原因是没调用 r.ParseMultipartForm 或参数设置不当。Go 的 http.Request 默认只解析 application/x-www-form-urlencoded，对 multipart/form-data 需显式解析，且必须在读取 r.FormFile 前完成。
关键点：
r.ParseMultipartForm(32 中的数值是内存缓冲上限（这里是 32MB），超过该值会自动写入临时磁盘；设太小会导致频繁落盘，设太大可能 OOM- 若未调用此方法就直接用
r.FormFile，会返回nil, nil（不是错误！容易误判为“没传文件”） - 如果前端用了
fetch但没设Content-Type: multipart/form-data（实际应由浏览器自动设置，手动设反而出错），也可能触发解析失败
如何避免大文件上传阻塞 HTTP 处理器？
Go 默认的 http.Server 是同步处理每个请求，上传大文件时会长时间占用 goroutine 和连接，影响并发能力。不能靠加 goroutine 包裹 handler 来解决——这只会让阻塞转移到后台，仍耗尽资源。
可行方案：
- 用
http.MaxBytesReader包裹r.Body，限制单次请求总大小，提前拒绝超限请求：http.MaxBytesReader(w, r, int64(50
- 设置
http.Server.ReadTimeout和ReadHeaderTimeout，防止慢速上传拖垮服务 - 对 >10MB 的文件，建议前端分片上传 + 后端合并，Go 侧用
io.MultiWriter或临时文件拼接，而非全量加载到内存
本地存储时为什么文件名被截断或乱码？
用户上传的原始文件名来自 header.Filename，它可能含路径（如 ../../etc/passwd）、非 ASCII 字符（中文、emoji）、空格或特殊符号。直接拼接进 os.OpenFile 路径会引发安全或兼容问题。
安全做法：
- 用
path.Base(header.Filename)剥离路径，再用正则过滤非法字符（如[^a-zA-Z0-9._-]替换为空） - 中文名建议转成 UUID + 原扩展名：
uuid.NewString() + filepath.Ext(filename)，避免编码差异（Windows/macOS/Linux 对 UTF-8 文件名支持不一） - 不要依赖
Content-Type判断文件类型——它可被伪造；应使用net/http.DetectContentType检查前 512 字节
用 MinIO 替代本地磁盘时要注意哪些配置？
MinIO 兼容 S3 API，但 Go 客户端（minio-go）默认行为和 AWS SDK 有差异，容易踩坑。
实操要点：
- 初始化 client 时，
secure: false必须与 MinIO 启动参数一致（--insecure），否则 TLS 握手失败报x509: certificate signed by unknown authority - 上传对象前，确保 bucket 已存在且权限正确：
client.MakeBucket(ctx, "uploads", minio.MakeBucketOptions{})，否则PutObject会静默失败（返回minio.ErrorResponse{Code:"NoSuchBucket"}） - 避免在 handler 内反复 new client：复用全局 client 实例，否则连接池失控，出现
dial tcp: too many open files
真正麻烦的是并发上传时的元数据一致性——比如多个请求同时写同一个 key，MinIO 不提供原子重命名，得靠业务层加分布式锁或用唯一前缀（如 user_id/timestamp/uuid）规避覆盖。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
