minio.New初始化后必须立即调用BucketExists探活，因仅解析参数不发网络请求；PutObject禁用[]byte/os.ReadFile防OOM，GetObject后必须Close防fd泄露。
直接在 Echo 框架里集成 MinIO，最常卡住的地方不是路由或中间件，而是 minio.Client 初始化后没做探活、PutObject 传了 []byte 或 os.ReadFile、GetObject 返回后漏掉 Close() —— 这三处不处理，压测时必出 too many open files 或静默上传截断。
minio.New 初始化后必须立刻调用 BucketExists 探活
minio.New 只解析参数，不发任何网络请求。返回非 nil 的 client 不代表能连上服务，endpoint 写错、Secure 配反、证书不信任、凭据大小写/空格不一致，全都会藏到第一次真实调用才暴露。
- 务必在
main()初始化 client 后，立即执行client.BucketExists(ctx, "probe-bucket")，哪怕桶名不存在 - 如果
err != nil，说明认证失败、DNS 解析失败、TLS 握手卡死（比如本地 HTTP 却设了Secure: true）或签名版本不匹配 - 不要用
MakeBucket替代探活：它对已存在桶会返回minio.ErrBucketAlreadyOwnedByYou，这不是健康信号 - 推荐搭配
context.WithTimeout(context.Background(), 10*time.Second)，避免探活本身 hang 住
Echo 处理文件上传时 PutObject 别碰 os.ReadFile
Echo 的 c.FormFile("file") 返回的是 *multipart.FileHeader，直接 header.Open() 得到 multipart.File（本质是 *os.File），这才是安全的流式 reader；若先 os.ReadFile 或转成 []byte，大文件直接 OOM。
- 打开后传给
PutObject第三个参数：file, _ := header.Open()→client.PutObject(ctx, bucket, objectName, file, -1, minio.PutObjectOptions{ContentType: "application/octet-stream"}) - 第四个参数设为
-1，让 SDK 自动按 5MB 分块；若需控制吞吐，显式传minio.PutObjectOptions{PartSize: 10 * 1024 * 1024} - 务必用带超时的 context：
ctx, cancel := context.WithTimeout(c.Request().Context(), 5*time.Minute)，否则默认无限等待，K8s 下易被 liveness probe 杀掉 - 上传完校验：
uploadInfo.Size == file.Stat().Size()，防止网络中断导致静默截断
GetObject 下载响应流必须 Close 且不能直接 io.ReadAll
client.GetObject 返回的是 *minio.Object，底层持有 HTTP 连接和 fd；不 Close() 会导致连接池耗尽、fd 泄露，高频请求下很快触发 too many open files。
Echo框架 5.1.0 版本源码包下载，适合关注 RealIP 行为变化、StartConfig.Listener、NewDefaultFS 和观测性中间件入口的开发团队。
立即学习“go语言免费学习笔记（深入）”；
- 必须在
GetObject成功后立刻写defer obj.Close()，且放在if err != nil判断之后 - 别对任意大小的对象用
io.ReadAll(obj)：小文件可接受，但大文件会全量进内存；应改用io.Copy(c.Response(), obj)直接流式写入 HTTP 响应体 - 设置响应头：
c.Header("Content-Type", obj.ContentType())和c.Header("Content-Length", strconv.FormatInt(obj.Size(), 10))，避免浏览器无法识别类型或进度条异常 - 对象不存在时
GetObject仍可能返回非 nil 的*minio.Object+err == nil，但后续Read立即 EOF —— 所以必须先判err，再操作obj
并发上传时复用 client 要注意连接池和凭证生命周期
minio.Client 是线程安全的，但错误复用方式会导致连接池打满、TCP TIME_WAIT 暴增，甚至凭证过期后请求持续 403。
- 全局只初始化一次 client，定义为包级变量或注入到 Echo 的
echo.Context中（如c.Set("minio", client)） - 不要每次 HTTP 请求都 new client：SDK 内部维护长连接池，频繁重建会快速占满 Linux 默认 65536 端口
- 若需对接多个 MinIO 实例（dev/staging/prod），用
map[string]*minio.Client缓存，key 为环境名，避免重复 dial - 凭证失效（如临时 STS token 过期）不会自动刷新，若用
credentials.NewStaticV4，则无需担心；若用credentials.NewIAM，需确保 EC2 实例角色或 EKS IRSA 配置正确
真正难的不是写通流程，而是每一步都得检查 err、每个 io.ReadCloser 都得 Close、每个 context 都得带 timeout —— 这些点漏一个，服务跑几天后就会在凌晨三点开始报 context deadline exceeded 或 connection refused，而日志里根本看不出哪行代码惹的祸。
