springboot程序文件上传集成腾讯云cos

前提：有腾讯云服务器并开通cos对象存储

1. 创建cos存储桶（访问权限需要设置为共有读私有写，这样到时上传的文件才可以通过链接访问）

   

2. 创建cos对象存储访问密钥拿到secretId和secretKey

   
   

   注意创建的密钥一定要保存好后期是无法再次次查看的
   

3. 在项目中添加腾讯云cos坐标

<!--      腾讯云cos坐标-->
      <dependency>
          <groupId>com.qcloud</groupId>
          <artifactId>cos_api</artifactId>
          <version>5.6.155</version>
      </dependency>
  </dependencies>

4. 创建文件上传工具类UploadUtil.java

package org.example.utils;

import com.qcloud.cos.COSClient;
import com.qcloud.cos.ClientConfig;
import com.qcloud.cos.auth.BasicCOSCredentials;
import com.qcloud.cos.auth.COSCredentials;
import com.qcloud.cos.http.HttpProtocol;
import com.qcloud.cos.model.PutObjectRequest;
import com.qcloud.cos.model.PutObjectResult;
import com.qcloud.cos.region.Region;

import java.io.File;

public class UploadUtil {
    /**
     * 该函数用于上传指定文件至腾讯云对象存储服务（COS），并返回上传后文件的HTTP访问链接。
     *
     * @param secretId 用户的SecretId，用于身份验证，建议使用具有最小权限的子账号密钥。
     * @param secretKey 用户的SecretKey，与SecretId配合使用进行身份验证，同样建议使用子账号密钥。
     * @param bucketName 存储桶名称，指定文件将上传到的存储桶。
     * @param regionName 存储桶所在地域的简称，参考腾讯云官方文档获取有效地区名称。
     * @param file 待上传的本地文件对象。
     * @param fileName 文件上传到COS后的对象键，即文件路径。
     *
     * @return 返回一个字符串类型的URL，表示上传成功后文件在COS中的访问地址。
     *
     * @throws IllegalArgumentException 如果输入的参数不合法或上传过程中出现异常，则可能会抛出异常。
     *
     * 注意：此函数依赖于腾讯云COS Java SDK，需要预先初始化相关配置并设置好用户凭证信息。
     */

    public static String uploadFileToCos(String secretId, String secretKey, String bucketName, String regionName, File file, String fileName) {
        // 1 初始化用户身份信息（secretId, secretKey）。
        COSCredentials cred = new BasicCOSCredentials(secretId, secretKey);
        // 2 设置 bucket 的地域, COS 地域的简称请参见 https://cloud.tencent.com/document/product/436/6224
        Region region = new Region(regionName);
        ClientConfig clientConfig = new ClientConfig(region);
        // 这里建议设置使用 https 协议
        // 从 5.6.54 版本开始，默认使用了 https
        clientConfig.setHttpProtocol(HttpProtocol.https);
        // 3 生成 cos 客户端。
        COSClient cosClient = new COSClient(cred, clientConfig);

        // 指定文件上传到 COS 上的路径，即对象键。例如对象键为 folder/picture.jpg，则表示将文件 picture.jpg 上传到 folder 路径下
        PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, fileName, file);
        PutObjectResult putObjectResult = cosClient.putObject(putObjectRequest);
        return "https://"+bucketName+".cos."+regionName+".myqcloud.com/"+fileName;
    }
    /**
     * 该函数用于校验文件类型是否合法。
     *
     * @param fileType 文件类型。
     *
     * @return 是否通过格式校验
     */

    public static boolean isValidFileType(String fileType) {
        // 定义允许的文件类型列表
        String[] allowedFileTypes = { "jpg", "jpeg", "png", "gif", "mp4" };
        for (String allowedType : allowedFileTypes) {
            if (allowedType.equalsIgnoreCase(fileType)) {
                return true;
            }
        }
        return false;
    }


}

5. 实现接口

package org.example.controller;

import jakarta.servlet.ServletOutputStream;
import jakarta.servlet.http.HttpServletResponse;
import org.example.pojo.Result;
import org.example.utils.UploadUtil;
import org.springframework.http.MediaType;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.net.URLEncoder;
import java.util.UUID;

/**
 * 文件处理接口
 */
@RestController
public class FileUploadController {

    private static final String ACCESS_KEY_ID = "XXX";//密钥secretId
    private static final String ACCESS_KEY_SECRET = "XXX";//密钥secretKey
    private static final String REGION = "XXX";//存储桶所在区域
    private static final String BUCKET_NAME = "XXX";//存储桶名称

    /**
     *上传文件到腾讯云cos
     */
    @PostMapping("/uploadToCos")
    public Result<String> uploadToCos(MultipartFile file) throws IOException {
        //判断文件是否为空
        if (file == null || file.isEmpty()) {
            return Result.error("文件不能为空");
        }
        //获取上传文件名
        String originalFilename = file.getOriginalFilename();
        String fileType = originalFilename.substring(originalFilename.lastIndexOf(".") + 1);
        // 对文件类型进行检查
        if (!UploadUtil.isValidFileType(fileType)) {
            return Result.error("不支持的文件类型");
        }

        //保证文件名唯一  防止文件覆盖
        String fileName = UUID.randomUUID().toString() + originalFilename.substring(originalFilename.lastIndexOf("."));
        //MultipartFile转换为file
        File tempFile = File.createTempFile(fileName, null);

        try {
            file.transferTo(tempFile);
            //上传到腾讯云
            String url = UploadUtil.uploadFileToCos(ACCESS_KEY_ID, ACCESS_KEY_SECRET, BUCKET_NAME, REGION, tempFile, fileName);
            //返回前端文件地址
            return Result.success(url);
        } catch (IOException e) {
            // 处理异常，如记录日志，返回错误信息等
            e.printStackTrace();
            return Result.error("文件上传失败");
        } finally {
            // 删除临时文件
            tempFile.delete();
        }
    }
}

6. 上传超过后可以在存储桶中看到自己上传的文件