minio 客户端初始化需正确传参：endpoint填"localhost:9000"等无协议地址，secure按tls启用情况设true/false，accesskey/secretkey须与服务端一致；上传前须用bucketexists检查并makebucket（region固定为"us-east-1"，bucket名全小写且符合长度与字符限制）；getobject后必须defer obj.close()，避免fd泄露。
怎么初始化 MinIO 客户端（minio.New 的参数别填错）
MinIO 客户端初始化不是传个 URL 就完事，minio.New 第二个参数是 secure 布尔值，它直接决定底层用 HTTP 还是 HTTPS——填错会导致连接被拒绝或证书错误，尤其本地调试时容易忽略。
-
endpoint不要带http://或https://，只写域名或 IP + 端口，比如"localhost:9000" - 如果 MinIO 服务启用了 TLS（比如用官方 Docker 镜像加了证书），
secure必须为true；否则一律设false - AccessKey 和 SecretKey 要和 MinIO 服务启动时配置的一致（默认是
minioadmin/minioadmin），大小写敏感
上传文件时为什么报 InvalidArgument: The specified bucket does not exist
MinIO 不会自动创建 bucket，上传前必须显式调用 MakeBucket，且要处理已存在的情况，否则第二次运行就 panic。
- 用
client.BucketExists先检查，再决定是否MakeBucket，别依赖 try-catch -
MakeBucket的第二个参数是 region，MinIO 目前只认"us-east-1"，填其他值会失败 - bucket 名必须全小写、不能含下划线、长度 3–63 字符，否则
MakeBucket直接返回 error
下载文件用 GetObject 后怎么安全读取内容
GetObject 返回的是 *minio.Object，本质是流式 reader，不手动 close 会导致 fd 泄露，压测时容易崩。
- 务必用
defer obj.Close()，别等 GC - 别直接
io.ReadAll(obj)读大文件，内存爆掉；小文件（ - 想存到本地？用
io.Copy写入*os.File，比自己循环Read更稳 - 注意
obj.Stat().Size是对象大小，但某些 proxy 场景可能不准，别用来做 buffer 预分配依据
为什么 ListObjectsV2 返回空，但明明有文件
MinIO 的 ListObjectsV2 默认只列 root 层级，且 prefix 匹配是「前缀严格匹配」，不是模糊搜索。
- 要递归列出所有文件，必须传
minio.ListObjectsOptions{Recursive: true} - prefix 如果带
/结尾（比如"logs/"），它只匹配目录；不带结尾（"logs"）才匹配logs-2024.txt这类文件名 - MinIO 默认不支持通配符，
*或?在 prefix 里无效，别试 - 如果对象名含中文或特殊字符，确保上传时用 UTF-8 编码，List 时不会自动 decode
MinIO 的 Go SDK 行为和 AWS S3 SDK 高度兼容，但「自动创建 bucket」「region 自适应」「prefix 模糊匹配」这些惯性认知恰恰是踩坑高发区。真正上线前，至少拿一个带子目录、中文名、100MB 文件的 case 过一遍全流程。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
