本文共 3343 字，大约阅读时间需要 11 分钟。

阿里云OSS文件上传功能开发指南

操作步骤

在开始开发之前，请确保已完成以下准备工作

    
    
     
      com.aliyun
     
    
     
      aliyun-sdk-oss
     
    
     
      3.8.0
     
    

工具类开发指南

本节将介绍如何通过代码实现阿里云OSS文件上传功能

1. 工具类概述

@Slf4j
public class AliOssUtils {
    // 请在实际应用中替换为您的实际配置信息
    private static final String endpoint = "your-oss-endpoint";
    private static final String accessKeyId = "your-access-key-id";
    private static final String secretAccessKey = "your-secret-access-key";
    private static final String bucketName = "your-bucket-name";
    
    // 上传文件的默认存储路径
    public static final String dirDefault = "default/";
    // 业务相关的上传路径
    public static final String dirBusiness = "business/";
    
    // 上传文件接口
    public static String upload(MultipartFile file) {
        return uploadOss(getFileName(file), getInputStream(file));
    }
    
    // 上传文件到指定目录
    public static String upload(String dir, MultipartFile file) {
        return uploadOss(dir + getFileName(file), getInputStream(file));
    }
    
    // 上传文件到指定目录并指定文件名
    public static String upload(String dir, String fileName, InputStream is) {
        return uploadOss(dir + fileName, is);
    }
    
    // 上传文件到OSS（核心上传逻辑）
    private static String uploadOss(String key, InputStream is) {
        try {
            OSS ossClient = new OSSClientBuilder()
                .withEndpoint(endpoint)
                .withAccessKeyId(accessKeyId)
                .withSecretAccessKey(secretAccessKey)
                .build();
            
            // 上传文件
            ossClient.putObject(bucketName, key, is);
            
            // 设置文件访问权限（默认为公开读取）
            ossClient.setObjectAcl(
                bucketName,
                key,
                CannedAccessControlList.PublicRead
            );
            
            ossClient.shutdown();
            
            return String.format(
                "https://%s.%s/%s",
                bucketName,
                endpoint,
                key
            );
        } catch (Exception e) {
            log.error("uploadOss Exception", e);
            return null;
        }
    }
    
    // 获取文件输入流
    private static InputStream getInputStream(MultipartFile file) {
        try {
            return file.getInputStream();
        } catch (Exception e) {
            log.error("getInputStream Exception", e);
            throw new BusinessException("文件流获取失败");
        }
    }
    
    // 生成文件名称
    private static String getFileName(MultipartFile file) {
        String originalFilename = file.getOriginalFilename();
        if (StringUtils.isNotBlank(originalFilename)) {
            return getFileName() + originalFilename.substring(
                originalFilename.lastIndexOf('.')
            );
        }
        return getFileName();
    }
    
    // 生成文件唯一标识符
    private static String getFileName() {
        return UUID.randomUUID().toString().replace("-", "") + LocalDate.now().toString().replace("-", "");
    }
}

注意事项

通过以上代码实现，您可以轻松将文件上传至阿里云OSS存储空间，并获取文件的访问URL。