# ADR-0002:本地对象存储通过兼容层接入 - 状态:待验证 - 日期:2026-08-05 ## 背景 平台后端和管理端当前直接依赖阿里 OSS SDK。只替换连接地址不能构成本地部署,必须先解耦 SDK 和业务逻辑。 ## 暂定决策 业务代码使用统一对象存储接口,至少实现 Alibaba OSS 与本地 S3 兼容存储两个 provider。具体本地产品不在完成兼容性测试前锁定;优先评估客户已有 S3 服务与许可证清晰、可离线交付的候选方案。 ## 准入测试 - 服务端上传/下载/删除、对象存在性和元数据; - 浏览器预签名 PUT/GET、CORS 和过期行为; - 分片上传、大文件、中文文件名和内容类型; - 权限隔离、凭证轮换、审计和容量配额; - 备份、恢复、升级、磁盘满和异常断电恢复; - 与现有 OSS URL/对象数据的迁移和回滚。 通过准入测试并确认许可证、运维与备份责任后,再将选定实现加入正式 Compose。