MinIO无法访问localhost:9000因默认绑定127.0.0.1而非localhost（IPv6解析问题），应改用127.0.0.1:9000或启动时指定--address :9000；Go客户端需设secure:false、region:"us-east-1"并确保时间同步。
MinIO服务启动后无法访问 localhost:9000
默认 MinIO 启动后监听的是 127.0.0.1:9000，不是 localhost:9000 —— 表面一样，但某些系统（尤其是 macOS 或启用了 IPv6 的环境）里，localhost 可能解析为 ::1，而 MinIO 没绑定 IPv6 地址，导致浏览器打不开。
- 启动时显式指定
--address :9000（注意前面的冒号），让 MinIO 监听所有接口，包括 IPv6 和 IPv4 - 或者用
127.0.0.1:9000替代localhost:9000浏览，更稳妥 - 检查防火墙或 Docker 网络：如果用 Docker 运行，确认
-p 9000:9000已正确映射，且没被其他进程占端口（lsof -i :9000或netstat -an | grep 9000）
Go 客户端初始化报错 failed to initialize minio client
常见于凭据、Endpoint 或 SSL 配置不匹配。MinIO 默认关闭 HTTPS，但 Go SDK（minio-go）新版默认启用 SSL 校验，连本地 HTTP 地址会直接拒绝。
- 确保
endpoint不带http://或https://前缀，只写"127.0.0.1:9000" - 显式传
secure: false，例如：minio.New("127.0.0.1:9000", "YOUR-ACCESS-KEY", "YOUR-SECRET-KEY", false) - AccessKey/SecretKey 必须和 MinIO 启动时一致（默认是
minioadmin/minioadmin），大小写敏感 - 若用
minio-go/v7，构造函数已改为minio.New+minio.Options结构体，别混用旧版函数签名
上传文件时提示 SignatureDoesNotMatch
这不是权限问题，而是客户端和服务端对请求签名的计算方式不一致，通常由时间偏差或 Region 配置引发。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- MinIO 本地模式不依赖 AWS Region，但 SDK 若未指定
region，可能 fallback 到us-east-1，导致签名失败；初始化时强制设region: "us-east-1"（MinIO 兼容此值） - 宿主机和 MinIO 容器时间差超过 15 分钟会触发签名拒绝，运行
docker run --rm --privileged alpine hwclock -s（Linux）或检查系统时间同步 - 避免在 URL 中拼接 query 参数再发请求——SDK 应走标准
PutObject方法，不要手动构造签名请求
测试代码跑通但生产环境连不上 MinIO
本地开发常忽略网络隔离细节：Docker 容器内 Go 程序访问 127.0.0.1 指向容器自身，而非宿主机 MinIO。
立即学习“go语言免费学习笔记（深入）”；
- Go 程序若也在 Docker 中运行，
endpoint应改用宿主机 IP（如172.17.0.1:9000）或 Docker 自定义网络中的服务名（如minio:9000） - MinIO 启动命令加
--console-address :9001单独暴露控制台端口，避免和 API 端口混淆 - 环境变量注入凭据比硬编码更安全，但注意 Go
os.Getenv返回空字符串时不会报错，建议加非空校验
Region 和时间同步这两个点，十次连不上有八次栽在这儿。
