上传签名与对象存储对接指南

概述

本章节介绍如何为“设计助手/虚拟试衣”接入对象存储与上传签名，完成素材上传与生成结果的落地访问。

步骤一：选择对象存储

• 推荐使用 S3 兼容存储（如 Amazon S3 / 阿里云 OSS / MinIO）
• 为项目创建独立存储桶（Bucket），开启合理的读写策略与 CORS 规则

步骤二：后端生成上传签名

• 在后端实现“创建上传 URL”接口，返回 uploadUrl 与 objectKey
• 前端以 PUT 上传文件到 uploadUrl，后端仅负责签名生成与记录

步骤三：前端上传与记录

• 用户选择文件后，调用“签名接口”获取 uploadUrl
• 通过 fetch(put) 直接上传到对象存储
• 将 objectKey 与业务参数一并提交到生成/渲染接口，便于产出结果与回显

步骤四：结果图落地与访问

• 生成完成后，后端将结果图写入对象存储并返回可读 URL（CDN/公有读）
• 前端直接使用该 URL 渲染与下载

安全与合规

• 使用短时有效的上传签名（如 5～15 分钟）
• 针对多租户业务，按租户维度区分路径前缀与访问权限
• 记录上传与读写操作日志，建设审计能力

常见问题

• 跨域失败：检查存储桶的 CORS 配置是否允许来源与方法（PUT/GET）
• 访问403：确认对象策略与签名有效期，避免过期或权限不足