OSS（对象存储服务）详解
1. 是什么？
OSS（Object Storage Service） 是阿里云提供的海量、安全、低成本的云存储服务，用于存储和管理任意类型的文件（如图片、视频、文档等）。
核心特点：
无限容量：按需扩展，无需提前规划存储空间。高可靠性：数据多副本存储，保障99.9999999999%（12个9）的持久性。低成本：按实际使用量付费，无闲置费用。高并发访问：支持CDN加速，适合大流量场景。
2. 能解决什么问题？
✅ 文件存储与管理：替代自建文件服务器，避免运维成本。 ✅ 静态资源托管：存储网站图片、视频等静态资源，提升加载速度。 ✅ 备份与归档：长期保存日志、数据库备份等冷数据。 ✅ 跨地域访问：结合CDN实现全球加速。
3. 使用步骤（Java SDK）
(1) 开通OSS服务并获取密钥
登录阿里云OSS控制台创建Bucket（存储空间），选择地域和权限（如公共读/私有）。获取访问密钥（AccessKey ID和AccessKey Secret）。
(2) 引入SDK依赖（Maven）
(3) 上传文件示例
import com.aliyun.oss.OSS;
import com.aliyun.oss.OSSClientBuilder;
public class OSSDemo {
public static void main(String[] args) {
// 1. 配置OSS客户端
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com"; // 替换为你的Bucket地域
String accessKeyId = "your-access-key-id";
String accessKeySecret = "your-access-key-secret";
String bucketName = "your-bucket-name"; // Bucket名称
// 2. 创建OSSClient实例
OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
try {
// 3. 上传文件
String objectName = "images/example.jpg"; // 存储路径+文件名
String filePath = "D:/local-file.jpg"; // 本地文件路径
ossClient.putObject(bucketName, objectName, new File(filePath));
System.out.println("文件上传成功！");
// 4. 获取文件访问URL（私有文件需生成签名URL）
String url = ossClient.generatePresignedUrl(
bucketName,
objectName,
new Date(System.currentTimeMillis() + 3600 * 1000) // 1小时有效
).toString();
System.out.println("文件访问URL: " + url);
} catch (Exception e) {
e.printStackTrace();
} finally {
// 5. 关闭OSSClient
ossClient.shutdown();
}
}
}
(4) 常用操作
操作代码示例上传文件ossClient.putObject(bucketName, objectName, file)下载文件ossClient.getObject(bucketName, objectName, localFile)删除文件ossClient.deleteObject(bucketName, objectName)列举文件ObjectListing listing = ossClient.listObjects(bucketName)
4. 安全最佳实践
使用临时访问凭证（STS）：避免直接暴露AccessKey。设置Bucket权限：
私有（推荐）：所有请求需签名。公共读：仅允许读取（适合静态网站）。 防盗链：在Bucket设置中限制Referer。
5. 结合Spring Boot实战
(1) 配置OSS客户端Bean
@Configuration
public class OSSConfig {
@Value("${aliyun.oss.endpoint}")
private String endpoint;
@Value("${aliyun.oss.access-key-id}")
private String accessKeyId;
@Value("${aliyun.oss.access-key-secret}")
private String accessKeySecret;
@Bean
public OSS ossClient() {
return new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
}
}
(2) 封装上传服务
@Service
public class OSSService {
@Autowired
private OSS ossClient;
@Value("${aliyun.oss.bucket-name}")
private String bucketName;
public String uploadFile(MultipartFile file, String path) throws IOException {
String objectName = path + "/" + UUID.randomUUID() + "-" + file.getOriginalFilename();
ossClient.putObject(bucketName, objectName, file.getInputStream());
return objectName;
}
}
(3) 控制器调用
@RestController
public class FileController {
@Autowired
private OSSService ossService;
@PostMapping("/upload")
public String upload(@RequestParam("file") MultipartFile file) {
String url = ossService.uploadFile(file, "images");
return "文件访问地址: " + url;
}
}
官方文档：阿里云OSS文档