使用Python向MinIO上传Zip文件变为目录的问题排查与解决

问题原因 #

• 传入的file_name参数末尾带有斜杠/，MinIO会将带斜杠的对象路径识别为目录。
• 本地local_file_path指向的不是实际Zip文件，而是同名目录，导致上传后生成目录结构。

解决方案 #

• 修正file_name参数：确保文件名（如data.zip）不以/结尾，示例代码：

  minio_client.fput_object("bucket_name", "data.zip", "/local/path/to/data.zip")
  

• 校验本地文件路径：先确认路径指向有效文件，避免上传目录：

  import os
  if os.path.isfile(local_file_path):
      minio_client.fput_object("bucket_name", file_name, local_file_path)
  else:
      raise ValueError("指定路径不是有效Zip文件")
  

• 核实MinIO对象实际类型：部分情况下控制台会将前缀相似的对象显示为目录，可通过命令行确认：

  mc ls your-minio-alias/bucket_name/data.zip
  

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