minio客户端初始化必须校验endpoint协议与端口：本地开发用"localhost:9000"且secure设为false，生产环境用https域名且secure为true；endpoint不可带http://或https://前缀，须先调bucketexists再makebucket，桶名全小写、3–63字符。
MinIO 客户端初始化必须校验 endpoint 协议与端口
GoLand 里跑不通 MinIO 初始化，八成是 endpoint 写错了。官方默认监听 9000 端口，但控制台（Console）走的是 9090 ——你传给 minio.New() 的必须是对象存储服务地址，不是控制台地址。
常见错误现象：Connection refused 或 context deadline exceeded，尤其在 Docker 部署时容易把容器内网端口和宿主机映射端口搞混。
-
endpoint不要带http://或https://前缀（minio-gov7+ 要求显式传入secure: true/false） - 若用 HTTPS，需额外配置
minio.Options{Secure: true}，且证书必须可信（自签名证书需手动注册到 Go 的http.Transport） - 本地测试建议直接用
"localhost:9000"，避免 DNS 解析或网络策略干扰
上传前务必检查 bucket 是否存在，别硬写 MakeBucket
在 GoLand 调试时看到 make bucket failed: BucketAlreadyOwnedByYou 就说明你重复创建了 bucket——这不是报错，但会中断后续逻辑。MinIO 不允许同名 bucket 重复创建，也不提供“存在则跳过”的原子操作。
正确做法是先调用 BucketExists，再按需创建：
exists, err := minioClient.BucketExists(ctx, bucketName)
if err != nil {
log.Fatal(err)
}
if !exists {
err = minioClient.MakeBucket(ctx, bucketName, minio.MakeBucketOptions{})
if err != nil {
log.Fatal(err)
}
}
注意：BucketExists 返回 exists == false 并不等于 bucket 不存在——也可能是权限不足或网络不通，得结合 err 判断。
文件上传路径拼接要用 filepath.Join，别手拼字符串
在 GoLand 里调试上传失败，常因 filePath 拼错导致 os.Open 返回 no such file or directory。Windows 和 Linux 路径分隔符不同，硬写 "image/头像.jpg" 在 Windows 下会变成 image\头像.jpg，而 os.Stat 找不到。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
实操建议：
- 永远用
filepath.Join(dir, filename)拼接路径，它自动适配系统 - 上传前加一层
os.Stat校验，不要等minioClient.PutObject报错才处理 -
objectName是 MinIO 中的 key 名，可含路径（如"user/123/avatar.jpg"），但不能以/开头
测试上传逻辑时，优先用 GoLand 的 HTTP Client 插件验证 MinIO 服务
别一上来就跑 Go 代码——先确认 MinIO 本身可用。GoLand 自带的 .http 文件能快速验证基础连通性。
新建一个 minio-test.http，写入：
GET http://172.16.59.130:9000/minio/health/live
Authorization: Bearer {{accessKey}}:{{secretKey}}
然后点击执行。如果返回 200 OK，说明服务、认证、网络都通；否则问题不在 Go 代码，而在 MinIO 配置或网络层。
这个步骤省掉一半调试时间。很多人卡在 Go 代码里反复改 minio.New 参数，其实 endpoint 根本没响应。
MinIO 的 accessKey 和 secretKey 是静态凭证，一旦写死就别在代码里硬编码，尤其别提交到 Git ——用 GoLand 的环境变量注入或 .env 文件管理更安全。
