一、前言

阿里云對象存儲服務(OSS)是一種海量、安全、低成本、高可靠的云存儲服務。本文將詳細介紹如何在Spring Boot項目中集成阿里云OSS實現文件上傳功能。

二、準備工作

1. 獲取OSS配置信息

在開始前，您需要準備以下OSS配置信息：

• endpoint: OSS服務訪問端點

• access-key-id: 訪問密鑰ID

• access-key-secret: 訪問密鑰

• bucket-name: 存儲空間名稱

獲取方法參考：阿里云OSS配置獲取指南

三、項目集成

1. 添加Maven依賴

<dependency><groupId>com.aliyun.oss</groupId><artifactId>aliyun-sdk-oss</artifactId><version>3.17.0</version> 
</dependency>

2. 配置application.yml

survey:alioss:endpoint: your-endpointaccess-key-id: your-access-key-idaccess-key-secret: your-access-key-secretbucket-name: your-bucket-name

四、核心代碼實現

1. 屬性配置類

@Component
@ConfigurationProperties(prefix = "survey.alioss")
@Data
public class AliOssProperties {private String endpoint;private String accessKeyId;private String accessKeySecret;private String bucketName;
}

2. OSS工具類

@Data
@AllArgsConstructor
@Slf4j
public class AliOssUtil {private String endpoint;private String accessKeyId;private String accessKeySecret;private String bucketName;public String upload(byte[] bytes, String objectName) {OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);try {ossClient.putObject(bucketName, objectName, new ByteArrayInputStream(bytes));} catch (OSSException oe) {log.error("OSS異常: {}", oe.getMessage());} catch (ClientException ce) {log.error("客戶端異常: {}", ce.getMessage());} finally {if (ossClient != null) {ossClient.shutdown();}}// 構建文件訪問URLString fileUrl = String.format("https://%s.%s/%s", bucketName, endpoint, objectName);log.info("文件上傳到: {}", fileUrl);return fileUrl;}
}

3. 配置類

@Configuration
@Slf4j
public class OssConfiguration {@Bean@ConditionalOnMissingBeanpublic AliOssUtil aliOssUtil(AliOssProperties aliOssProperties) {log.info("創建阿里云文件上傳工具類對象");return new AliOssUtil(aliOssProperties.getEndpoint(),aliOssProperties.getAccessKeyId(),aliOssProperties.getAccessKeySecret(),aliOssProperties.getBucketName());}
}

4. 文件上傳接口

@RestController
@RequestMapping("/common")
@Slf4j
public class CommonController {@Autowiredprivate AliOssUtil aliOssUtil;@PostMapping("/upload")public Result<String> upload(MultipartFile file) {log.info("文件上傳: {}", file.getOriginalFilename());try {String originalFileName = file.getOriginalFilename();String extension = originalFileName.substring(originalFileName.lastIndexOf("."));String objectName = UUID.randomUUID().toString() + extension;String filePath = aliOssUtil.upload(file.getBytes(), objectName);return Result.success(filePath);} catch (IOException e) {log.error("文件上傳失敗: {}", e.getMessage());return Result.error("文件上傳失敗");}}
}

五、功能說明

1. 文件命名：使用UUID生成唯一文件名，避免文件名沖突

2. 異常處理：捕獲OSSException和ClientException，記錄詳細錯誤日志

3. 資源釋放：確保OSSClient在使用后被正確關閉

4. URL生成：按照阿里云OSS規范生成文件訪問URL

六、使用示例

前端可以通過表單提交文件到/common/upload接口，接口會返回文件的訪問URL。

七、注意事項

1. 確保阿里云OSS服務已開通

2. AccessKey需要妥善保管，不要泄露

3. 上傳大文件時考慮使用分片上傳

4. 生產環境建議添加文件大小限制和類型檢查

八、總結

本文詳細介紹了Spring Boot集成阿里云OSS實現文件上傳的完整方案，包括配置獲取、工具類封裝和接口實現。該方案具有以下優點：

• 代碼結構清晰，易于維護

• 完善的異常處理機制

• 可擴展性強，便于添加新功能

希望本文對您有所幫助，歡迎在評論區交流討論。