如何在Python中使用Flask与MinIO实现对象存储直传服务？-Python教程-PHP中文网

不能让前端直接调用MinIO API上传文件，因为MinIO默认启用签名认证，前端无法安全持有SECRET_KEY，暴露密钥等于开放存储桶写权限；必须由Flask生成预签名URL来控制上传。

如何在python中使用flask与minio实现对象存储直传服务？

为什么不能让前端直接调用MinIO API上传文件

因为 MinIO 默认启用签名认证，前端无法安全持有 SECRET_KEY，直接暴露 ACCESS_KEY 和 SECRET_KEY 到浏览器等于开放存储桶写权限。Flask 必须介入生成预签名 URL，把上传控制权收回来。

常见错误现象：SignatureDoesNotMatch 或 AccessDenied，本质是前端构造的签名参数（如 X-Amz-Date、X-Amz-Signature）与 MinIO 服务端校验不一致——这几乎总是因跳过 Flask 签名环节导致的。

MinIO 的 presigned_put_object() 生成的是带完整签名参数的 URL，前端只需用 PUT 方法发原始二进制数据过去，无需自己签名
URL 有效期建议设为 60–300 秒，太长增加被重放风险，太短导致大文件上传中断后无法续传
确保 MinIO 服务启用了 HTTPS，否则浏览器会阻止非安全上下文发起的预签名 URL PUT 请求

Flask 如何生成 MinIO 预签名上传 URL

核心是调用 minio.Minio.presigned_put_object()，但要注意：它返回的是完整 URL 字符串，不是字典；且必须提前确认目标 bucket_name 已存在并有写权限。

示例代码片段（关键部分）：

from minio import Minio
from flask import Flask, request, jsonify
<p>app = Flask(<strong>name</strong>)
client = Minio(
"minio.example.com:9000",
access_key="YOUR_ACCESS_KEY",
secret_key="YOUR_SECRET_KEY",
secure=True  # 必须和 MinIO 实际协议一致
)</p><p>@app.route("/upload-url", methods=["POST"])
def get_upload_url():
filename = request.json.get("filename")
bucket = "uploads"</p><h1>确保 bucket 存在（生产环境应提前创建好）</h1><pre class="brush:python;toolbar:false;">try:
    client.bucket_exists(bucket)
except:
    return jsonify({"error": "bucket not found"}), 400
# 生成 5 分钟有效期的上传 URL
url = client.presigned_put_object(bucket, filename, expires=300)
return jsonify({"upload_url": url})

filename 应做过滤，禁止路径遍历（如拒绝包含 ../ 或以 / 开头的值）
如果需要限制文件类型或大小，只能在 Flask 接口层做校验（例如检查 Content-Type 头），MinIO 预签名本身不支持这些约束
不要在响应中返回 access_key 或 secret_key，哪怕是一次性 token —— 这是典型密钥泄露场景

前端如何用预签名 URL 完成直传

拿到 Flask 返回的 upload_url 后，前端用原生 fetch() 发起 PUT，注意三点：不带任何自定义认证头、不修改 URL 参数、body 是原始 File 对象或 ArrayBuffer。

Biopython

全面的分子生物学工具集。适用于序列操作、文件解析（FASTA/GenBank/PDB）、系统发育分析，以及通过 Bio.Entrez 以编程方式访问 NCBI/

下载

错误写法：fetch(url, { headers: { Authorization: "..." } }) —— 预签名 URL 已含全部认证信息，加额外头会导致签名失效。

必须使用 PUT 方法，POST 不被 MinIO 预签名 URL 支持
若上传大文件，建议配合 AbortController 实现取消，避免用户关闭页面后请求仍在后台执行
上传成功响应状态码是 200，响应 body 为空；失败时浏览器会抛 NetworkError 或返回 403/400，需捕获 catch 并提示用户