最简单的文件上传-spring-file-storage_filestorage 官网-CSDN博客

本文链接：https://blog.csdn.net/ytyDaMoTou/article/details/128893435

SpringFileStorage是一个工具，支持多种OSS对象存储平台，如阿里云OSS、FTP等。在SpringBoot应用中，只需简单配置即可实现文件存储。文章提供了一个阿里云OSS的上传文件示例，包括依赖引入、配置、@EnableFileStorage注解的添加以及RESTfulAPI的创建。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

概述

Spring File Storage工具几乎整合了市面上所有的OSS对象存储平台，包括本地、FTP、SFTP、WebDAV、阿里云OSS、华为云OBS、七牛云Kodo、腾讯云COS、百度云 BOS、又拍云USS、MinIO、京东云 OSS、网易数帆 NOS等其它兼容 S3 协议的平台，只要在springboot中通过极简的方式就可以实现文件存储。

官网：https://spring-file-storage.xuyanwu.cn

案例：文件上传至阿里云OSS平台

1 导包

        <dependency>
            <groupId>com.aliyun.oss</groupId>
            <artifactId>aliyun-sdk-oss</artifactId>
            <version>3.10.2</version>
        </dependency>
        <dependency>
            <groupId>cn.xuyanwu</groupId>
            <artifactId>spring-file-storage</artifactId>
            <version>0.5.0</version>
        </dependency>

2 配置文件增加配置

spring:
  #文件存储配置(本地、oss)
  file-storage:
    default-platform: local-1
    thumbnail-suffix: ".min.jpg" #缩略图后缀
    local:
      - platform: local-1 # 存储平台标识
        enable-storage: true #是否开启本存储（只能选一种）
        enable-access: true #启用访问（线上请使用 Nginx 配置，效率更高）
        domain: "http://127.0.0.1:2222" #访问域名，注意后面要和path-patterns保持一致，“/”结尾
        base-path: /tmp/Pictures/ # 存储地址
        path-patterns: /** #访问路径
    aliyun-oss:
      - platform: aliyun-oss
        enable-storage: true
        access-key: 12312323
        secret-key: 32432434
        end-point: 435455545454543
        bucket-name: firebook
        domain: http://fire100.top
        base-path: #云平台文件路径

3 启动类增加@EnableFileStorage 注解

4 案例

4.1 上传文件

@RestController
@RequestMapping("/file")
@Api(tags = "文件管理api")
public class FileController {

    @Autowired
    private FileStorageService fileStorageService;

    @PostMapping("upload")
    @ApiOperation(value = "文件上传",notes = "文件上传")
    public R upload(MultipartFile file){
        FileInfo upload  = fileStorageService.of(file).upload();
        return R.ok(upload);
    }

    /**
     * 上传图片裁剪大小并生成一张缩略图
     */
    @PostMapping("/uploadThumbnail")
    public FileInfo uploadThumbnail(MultipartFile file) {
        return fileStorageService.of(file)
                .image(img -> img.size(1000,1000))  //将图片大小调整到 1000*1000
                .thumbnail(th -> th.size(200,200))  //再生成一张 200*200 的缩略图
                .upload();
    }

    /**ali
     * 上传文件到指定存储平台，成功返回文件信息
     */
    @PostMapping("/upload-platform")
    public FileInfo uploadPlatform(MultipartFile file) {
        return fileStorageService.of(file)
                .setPlatform("aliyun-oss")    //使用指定的存储平台
                .upload();
    }
}

其他案例请参照官网配置，至此，文件上传案例完毕