不能让前端直接调用MinIO API上传文件，因为MinIO默认启用签名认证，前端无法安全持有SECRET_KEY，暴露密钥等于开放存储桶写权限；必须由Flask生成预签名URL来控制上传。
为什么不能让前端直接调用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 已存在并有写权限。
示例代码片段（关键部分）：
立即学习“Python免费学习笔记（深入）”；
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。
错误写法：fetch(url, { headers: { Authorization: "..." } }) —— 预签名 URL 已含全部认证信息，加额外头会导致签名失效。
- 必须使用
PUT方法，POST不被 MinIO 预签名 URL 支持 - 若上传大文件，建议配合
AbortController实现取消，避免用户关闭页面后请求仍在后台执行 - 上传成功响应状态码是
200，响应 body 为空；失败时浏览器会抛NetworkError或返回403/400，需捕获catch并提示用户
上传完成后如何通知业务系统
MinIO 本身不触发回调，Flask 也不能监听对象写入事件（除非启用 minio events 并单独部署监听服务）。最轻量的做法是：前端上传成功后，再发一个 POST /upload-complete 给 Flask，带上文件名和元数据。
这个接口要做幂等处理（例如用 Redis 记录已确认的 filename + timestamp 组合），因为网络抖动可能导致重复通知。
- 不要在
/upload-url接口中直接写入数据库记录“待上传”，而应在/upload-complete中才落库 —— 否则会累积大量僵尸记录 - 如果业务需要生成缩略图或转码，此时才是触发异步任务（如 Celery）的合适时机，而非上传过程中阻塞等待
- MinIO 的
stat_object()可在此时调用，验证文件是否真实写入且大小匹配，防止前端伪造成功响应
实际跑通的关键不在 Flask 或 MinIO 单独配置，而在于三处衔接：Flask 生成的 URL 必须能被前端干净地 PUT 出去、MinIO 服务端必须用相同时间戳和密钥验签、上传完成后的业务确认不能依赖 MinIO 的“实时性”假设。
