springboot整合minio，实现文件上传与下载，且支持链接永久访问

最新推荐文章于 2025-10-10 11:18:13 发布

原创

最新推荐文章于 2025-10-10 11:18:13 发布 · 5.6k 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #java #后端

本文档详细介绍了如何使用Docker部署MinIO，并在SpringBoot应用中集成MinIO进行文件上传和下载。首先，通过Docker命令拉取并启动MinIO服务。然后，在项目中引入MinIO的依赖，配置MinioClient，并提供文件上传和下载的接口。在文件上传中，检查存储桶是否存在并上传文件；在文件下载中，提供了直接下载和生成预签名URL的两种方式。最后，展示了生成预签名URL的代码片段，允许用户通过该URL直接下载文件。

1、minio部署

1.1 拉取镜像

docker pull minio/minio

1.2 创建数据目录

mkdir -p /home/guanz/minio
mkdir -p /home/guanz/minio/midata

1.3 启动minio

docker run -d -p 9000:9000 -p 9001:9001 --restart=always -e MINIO_ACCESS_KEY=guanz -e MINIO_SECRET_KEY=guanz@123 -v $PWD/midata:/data  minio/minio server /data --console-address "192.168.1.139:9001"

2、项目搭建

2.1 引入jar

        <dependency>
            <groupId>io.minio</groupId>
            <artifactId>minio</artifactId>
            <version>8.0.3</version>
        </dependency>

2.2 application-dev.yml

spring
    minio:
    # Minio服务器地址
    endpoint: http://192.168.1.139:9000
    port: 9001
    create-bucket: true
    bucketName: push-test
    # Minio服务器账号
    accessKey: guanz
    # Minio服务器密码
    secretKey: guanz@123
    secure: false
    configDir: /home/push
    # 文件大小 单位M
    maxFileSize: 10
    expires: 604800

2.4 MinioConfig.java

package com.pavis.app.saasbacken.config;

import io.minio.MinioClient;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.stereotype.Component;

/**
 * @program: push-saas
 * @description:
 * @author: Guanzi
 * @created: 2021/11/02 13:47
 */
@Data
@Component
@ConfigurationProperties(prefix = "minio")
@Slf4j
@Configuration
public