springboot+阿里云oss上传文件

### Spring Boot 集成阿里云 OSS 文件上传

#### 依赖引入
为了使 Spring Boot 应用程序能够与阿里云 OSS 对象存储服务交互，需在 `pom.xml` 或构建工具配置文件中加入特定的 starter 组件。这一步骤简化了集成过程并提供了便捷的方法来操作 OSS 资源[^1]。

对于 Maven 构建系统而言，在 pom 文件内添加如下依赖项：

<dependency>
    <groupId>com Alibaba Cloud</groupId>
    <artifactId>spring-boot-starter-alicloud-oss</artifactId>
</dependency>

#### 配置参数设置
接着是在应用程序属性文件 application.yml (或 .properties) 中定义连接至 OSS 所必需的信息，比如访问密钥、区域端点以及目标存储桶名称等细节[^3]。

以下是 YAML 格式的样例配置片段：

aliyun:
  oss:
    endpoint: https://oss-cn-beijing.aliyuncs.com
    accessKeyId: 用户自己的Access Key ID
    accessKeySecret: 用户自己的Access Key Secret
    bucketName: 用户指定的Bucket名字

#### 控制层接口设计
当一切准备就绪之后，就可以着手编写用于处理客户端请求并将接收到的数据保存到云端的服务逻辑了。下面给出了一段简单的控制器代码示例，它接收 multipart/form-data 类型 POST 请求中的文件数据，并调用后台服务完成实际的上传工作[^2]。

@RestController
@RequestMapping("/api/file")
public class FileController {

    private final OssService ossService;

    @Autowired
    public FileController(OssService ossService){
        this.ossService = ossService;
    }

    /**
     * 头像照片上传API.
     */
    @PostMapping("uploadAvatar")
    public ResponseEntity<Map<String, Object>> uploadAvatar(@RequestParam MultipartFile file){
        try {
            // 使用注入的服务类执行上传动作
            String url = ossService.uploadFile(file);
            
            Map<String,Object> resultMap=new HashMap<>();
            resultMap.put("url",url);

            return new ResponseEntity<>(resultMap, HttpStatus.OK);
        } catch (Exception e) {
            logger.error(e.getMessage(),e);
            throw new RuntimeException("Upload failed");
        }
    }
}

上述例子展示了如何利用 spring-webmvc 提供的功能快速搭建起 RESTful API 接口，同时借助于之前提到过的 starter 来管理底层通信事务。