本地Docker部署MinIO时Python客户端检查存储桶存在触发SignatureDoesNotMatch报错的排查

存在的配置疏漏 #

• 签名错误的直接诱因：密钥填错：报错SignatureDoesNotMatch的核心原因是你写的secret_key是inioadmin，比MinIO默认的根密码minioadmin少了开头的m。S3的请求签名是通过密钥计算的，只要密钥有一个字符不对，服务端校验时就会判定签名不匹配，直接拒绝请求。
• Endpoint选择不合理：你代码里填的172.17.0.2:9000是MinIO容器在Docker桥接网络里的内网虚拟IP，这个地址只供Docker网络内的容器之间互相访问，重启容器后这个IP大概率会随机变化，不适合给宿主机上运行的Python客户端使用，也和你浏览器正常访问控制台的入口不一致。

正确的连接与校验实现 #

1. 先修正两项配置错误：
   • 把endpoint替换成本地可稳定访问的127.0.0.1:9000，不要用Docker内网的容器IP
   • 把secret_key修正为和MinIO实际运行凭证一致的值：默认启动状态下根账号密码都是minioadmin，如果之前你通过环境变量自定义过账号密码，就替换成你设置的自定义值
2. 修正后的代码参考：

from minio import Minio

# 初始化客户端
client = Minio(
    endpoint="127.0.0.1:9000",
    access_key="minioadmin",
    secret_key="minioadmin",
    secure=False  # 本地HTTP访问无需启用HTTPS
)

# 校验存储桶是否存在
bucket_exists = client.bucket_exists("aaabbb")
if not bucket_exists:
    print("Bucket 'aaabbb' not found")
else:
    print("Bucket 'aaabbb' already exists")

提示：MinIO启动时已经明确提示默认凭证存在安全风险，正式使用时一定要通过环境变量MINIO_ROOT_USER和MINIO_ROOT_PASSWORD配置自定义的强账号密码，不要长期使用默认的minioadmin组合。

内容的提问来源于stack exchange，提问作者Boom