minio go sdk初始化时endpoint必须为纯地址+端口（如"localhost:9000"），不含协议头或尾部斜杠，secure参数按实际协议设为false（http）或true（https），否则报invalid endpoint；上传大文件须流式处理，下载后必须defer obj.close()防fd泄露。
MinIO 不是“框架”，也不是用来“构建分布式文件系统”的底层库——它本身就是一个开箱即用的、可水平扩展的分布式对象存储服务。你用 Go 调它的 API，不是在“构建”它，而是在“集成”它。
minio-go 初始化时 endpoint 和 secure 怎么填才不报 invalid endpoint
错误基本都出在 endpoint 格式和 secure 布尔值不匹配上：
-
endpoint必须是纯地址+端口，不含http://或https://，也不能带尾部斜杠，比如"127.0.0.1:9000"或"play.min.io" -
secure不是“要不要加密”，而是“是否走 HTTPS 协议”：本地 MinIO 默认 HTTP，这里必须传false；如果你启用了 TLS（比如用官方 Docker 镜像挂了证书），才设为true - Go 模块要对齐版本：
go get github.com/minio/minio-go/v7，v6 或 v8 会因接口变更导致编译失败
上传大文件时内存爆掉，PutObject 怎么写才安全
直接传 []byte 或用 os.ReadFile 加载整个文件，等于把几百 MB 全塞进内存，OOM 是常态。正确做法是流式上传：
- 打开文件后，直接传
*os.File给PutObject，不要读取全部内容 - 第四个参数 size 设为
-1，SDK 会自动按默认 5MB 分块上传；如需自定义，用minio.PutObjectOptions{PartSize: 10 * 1024 * 1024} - 务必比对上传结果：
uploadInfo.Size == sourceFile.Stat().Size()，网络中断时 SDK 可能静默截断而不报错
GetObject 下载后不 close 会怎样
返回的是 *minio.Object，本质是带缓冲的 io.ReadCloser，底层持有 HTTP 连接和文件描述符：
- 漏掉
defer obj.Close()，fd 泄露会在压测或高频调用时迅速耗尽系统资源，进程被 OS kill - 别用
io.ReadAll(obj)读大文件——内存暴涨，且无法流式处理；小文件（ - 想存到本地？用
io.Copy(dstFile, obj)，比手动Read/Write更稳，也自动处理 buffer 复用
ListObjectsV2 为什么总返回空
MinIO 的列表行为和直觉相反，关键在两个参数：
-
prefix是严格前缀匹配：传"logs/"只匹配目录名，传"logs"才能匹配logs-2024.txt - 默认不递归，必须显式传
minio.ListObjectsOptions{Recursive: true}，否则只列 root 层级 - MinIO 不支持通配符，
prefix里写"*.jpg"或"log?"完全无效 - 对象名含中文或特殊字符时，上传和 list 都用 UTF-8 编码，SDK 不自动 decode，别在 prefix 里做 URL decode
真正容易被忽略的点是：MinIO 的 bucket 创建、region 固定为 "us-east-1"、bucket 名必须全小写且长度 3–63 字符——这些约束不报明确错误，但会让 MakeBucket 静默失败或后续所有操作 404。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
