Golang集成MinIO实现对象存储文件管理-Golang-PHP中文网

minio客户端初始化失败的三个硬性条件：endpoint不能带协议头和尾部斜杠；secure必须显式设为true或false；凭证需用credentials.newstaticv4构造且与服务端一致。

golang集成minio实现对象存储文件管理

客户端初始化不是“填完参数就完事”，漏掉任意一个，后续所有操作都会 panic 或静默失败。

endpoint 必须是纯主机+端口格式，不能带 http:// 或 https://，也不能有尾部斜杠；正确写法是 "localhost:9000" 或 "minio.example.com:9000"
Secure 参数必须显式指定：false 对应 HTTP 本地开发，true 对应 HTTPS 生产环境；默认为 true，连本地 HTTP 地址会直接报 x509: certificate signed by unknown authority
凭证必须用 credentials.NewStaticV4 构造，且 accessKey 和 secretKey 要与 MinIO 服务启动时一致（默认是 "minioadmin"/"minioadmin"）

初始化后别急着上传，立刻调一次 client.BucketExists(ctx, "test") 或 client.ListBuckets(ctx) 做探活——这是唯一能提前暴露网络、权限、签名兼容性问题的方式。

不是 SDK 有问题，而是你把整个文件读进内存再传，或者没控制 HTTP 连接行为。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

绝对不要用 os.ReadFile 加载大文件再传给 PutObject；改用 os.Open 后直接传 *os.File，SDK 内部会按需流式读取
必须传带超时的 context.Context，例如 ctx, cancel := context.WithTimeout(context.Background(), 5*time.Minute)；否则默认无限等待，尤其在容器或 K8s 环境下极易 hang 住
第四个参数（object size）设为 -1 表示未知长度，SDK 自动按 5MB 分块；若想优化吞吐，可设 minio.PutObjectOptions{PartSize: 10*1024*1024}
上传完成后务必检查返回的 minio.UploadInfo.Size 是否等于源文件 os.Stat().Size()，防止网络中断导致静默截断

MinIO 没有目录结构，“文件夹”只是 key 名里的 /，List 默认不递归、也不匹配前缀，很容易以为“没东西”。

要列出桶内全部对象，必须传 minio.ListObjectsOptions{Recursive: true}
只想查某路径下一级内容（如 logs/2024/），设 Prefix: "logs/2024/" + Recursive: false；注意结尾的 / ——不加可能匹配到 logstash.json
如果上传了 logs/2024/01/app.log，但只设 Prefix: "logs"，默认不会返回任何对象，因为 "logs" 不是完整前缀（它后面没跟 /）

不是文件不存在，而是你跳过了最关键的错误检查步骤。

client.GetObject 返回两个值：obj, err；必须先判断 err != nil，再处理 obj；否则对象不存在、权限不足、ETag 不匹配时，obj 是个“假成功”的空壳，obj.ContentLength 可能为 0，io.Copy 写出来就是空文件
返回的 minio.Object 是 io.ReadCloser，必须用 defer obj.Close()，否则连接泄漏，反复调用后耗尽 HTTP idle connection
大文件下载别用 io.ReadAll，改用 io.Copy 直接到磁盘或 bufio.Writer 流式处理