当前位置：首页 > news >正文

✅阿里云-对象存储OSS-配置和使用（Java）

news 2025/10/5 9:24:51

OSS对象存储服务的创建和集成使用

在写项目的时候，使用到了上传文件的一些功能，通过该方式可以提高文件的访问速率。也可以就将文件存储到数据库。这里只是做一个记录。

1. OSS 服务配置

1.1 创建 Bucket

登录阿里云控制台，进入 OSS 管理界面
点击"创建 Bucket"
配置说明：

- Bucket 名称：air-test1
- 地域：选择杭州（oss-cn-hangzhou）
- 存储类型：标准存储
- 读写权限：公共读（如果不想设置公共读，需要使用签名URL）
- 版本控制：可选
- 服务端加密：可选

1.2 创建后设置

关闭阻止公共访问

读写权限：公共读

1.3 访问密钥配置

在阿里云控制台获取 AccessKey：

- AccessKey ID
- AccessKey Secret

出于安全考虑，建议：

- 使用 RAM 用户创建 AccessKey
- 只授予必要的 OSS 权限
- 定期轮换 AccessKey

创建RAM用户并授予对应的权限

进入用户管理控制台
创建用户，输入对应的名称就可以了（需要验证）

点击创建的用户，创建AccessKey（记住创建的AccessKey ID和AccessKey Secret）

1.4 项目配置

OSS地域和访问域名
配置系统变量ALIBABA_AIR_TEST1_ACCESSKEY_ID和ALIBABA_AIR_TEST1_ACCESSKEY_SECRET(对应的值就设置成上面的AccessKey ID和AccessKey Secret)

在 application.yml 中配置 OSS 参数：

aliyun:oss:endpoint: oss-cn-hangzhou.aliyuncs.comaccessKeyId: ${ALIBABA_AIR_TEST1_ACCESSKEY_ID}accessKeySecret: ${ALIBABA_AIR_TEST1_ACCESSKEY_SECRET}bucketName: air-test1urlPrefix: https://air-test1.oss-cn-hangzhou.aliyuncs.com/

环境变量配置：

export ALIBABA_AIR_TEST1_ACCESSKEY_ID=your_access_key_id
export ALIBABA_AIR_TEST1_ACCESSKEY_SECRET=your_access_key_secret

2. 代码实现

xml依赖

		<!-- 阿里云OSS --><dependency><groupId>com.aliyun.oss</groupId><artifactId>aliyun-sdk-oss</artifactId><version>3.15.1</version></dependency>

2.1 OSS 配置类

@Configuration
public class OSSConfig {@Value("${aliyun.oss.endpoint}")private String endpoint;@Value("${aliyun.oss.accessKeyId}")private String accessKeyId;@Value("${aliyun.oss.accessKeySecret}")private String accessKeySecret;@Value("${aliyun.oss.bucketName}")private String bucketName;@Beanpublic OSS ossClient() {return new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);}
}

2.2 OSS 工具类

@Component
public class AliOSSUtils {@Value("${aliyun.oss.endpoint}")private String endpoint;@Value("${aliyun.oss.accessKeyId}")private String accessKeyId;@Value("${aliyun.oss.accessKeySecret}")private String accessKeySecret;@Value("${aliyun.oss.bucketName}")private String bucketName;/*** 上传文件到OSS* @param file 要上传的文件* @param directory 存储的目录（可选，如：avatars/）* @return 文件访问URL*/public String uploadFile(MultipartFile file, String directory) throws IOException {// 获取上传的文件的输入流InputStream inputStream = file.getInputStream();// 生成唯一文件名String originalFilename = file.getOriginalFilename();String extension = originalFilename.substring(originalFilename.lastIndexOf("."));String fileName = (directory != null ? directory : "") + UUID.randomUUID().toString() + extension;// 创建OSSClient实例OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);try {// 上传文件到OSSossClient.putObject(bucketName, fileName, inputStream);// 构建文件访问路径return "https://" + bucketName + "." + endpoint + "/" + fileName;} finally {// 关闭OSSClientif (ossClient != null) {ossClient.shutdown();}// 关闭输入流if (inputStream != null) {inputStream.close();}}}/*** 上传图片到OSS（简化方法，不指定目录）*/public String uploadImage(MultipartFile file) throws IOException {return uploadFile(file, "images/");}/*** 上传头像到OSS*/public String uploadAvatar(MultipartFile file) throws IOException {return uploadFile(file, "avatars/");}
}

3. 使用说明

3.1 代码使用示例

上传头像：

@Autowired
private AliOSSUtils aliOSSUtils;public String uploadAvatar(MultipartFile file) {try {return aliOSSUtils.uploadAvatar(file);} catch (IOException e) {throw new RuntimeException("上传头像失败", e);}
}