springboot項目中利用騰訊云上傳存儲文件

更新時間：2025年12月15日 09:39:52 作者：屋外雨大，驚蟄出沒

本文主要介紹了springboot項目中利用騰訊云上傳存儲文件,文中通過示例代碼介紹的非常詳細,對大家的學習或者工作具有一定的參考學習價值,需要的朋友們下面隨著小編來一起學習學習吧

注冊與登錄

1.訪問騰訊云官網(wǎng)，注冊并登錄賬號。完成實名認證（這是必須的）。

2.開通COS服務

這里有指引，一步步照著點確定就行

在控制臺首頁搜索“對象存儲”或“COS”，進入產(chǎn)品頁面，點擊“立即使用”或“開通”。新用戶通常有免費額度。https://console.cloud.tencent.com/cos

創(chuàng)建一個存儲桶（Bucket）

這是最關鍵的一步，存儲桶就是你存放文件的“柜子”。

在COS控制臺，點擊“創(chuàng)建存儲桶”。

填寫配置：

名稱：起一個全球唯一的名字，比如 yourblog-private-msg-1250000000（后面的數(shù)字是你的APPID）。
地域：選擇離你用戶最近的地域，如“上海”。
訪問權限：務必選擇“公有讀私有寫”。這樣，用戶才能直接通過鏈接查看你發(fā)的圖片/文件，而上傳則需要你的授權（通過后端代碼）。

其他選項保持默認即可，點擊“創(chuàng)建”。

獲取你的API密鑰（SecretId & SecretKey）

這是你的“賬號密碼”，代碼用它來獲得操作COS的權限。

點擊網(wǎng)頁右上角你的賬號名稱，進入“訪問管理” -> “API密鑰管理”。

你會看到 SecretId 和 SecretKey。請像保護密碼一樣妥善保管，不要泄露或提交到公開的代碼倉庫（如GitHub）。

這里在創(chuàng)建密鑰的時候一定要選擇為下載csv文件，要不然后面很難寫對密鑰

3.代碼測試上傳是否成功

1）建立spring boot項目

2）在pom.xml文件里添加如下依賴

<dependency>
    <groupId>com.qcloud</groupId>
    <artifactId>cos_api</artifactId>
    <version>5.6.227</version>
</dependency>

3）在test/java目錄下編寫測試文件

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 CosSimpleTest {
    public static void main(String[] args) {
        // 1. 替換成你自己的信息（以下4項必須修改）
        String secretId = "AKIDug"; // 你的SecretId
        String secretKey = "eoq"; // 你的SecretKey（剛剛保存的那個長字符串）
        String region = "ap-shanghai"; // 存儲桶地域，如上海是 ap-shanghai
        String bucketName = "wx4-133"; // 你的存儲桶名稱

        // 2. 準備一個要上傳的本地測試文件（修改為你的文件絕對路徑）
        File localFile = new File("C:/pages/pure/cat.jpg"); // 示例路徑

        // 3. 初始化COS客戶端
        COSCredentials cred = new BasicCOSCredentials(secretId, secretKey);
        Region reg = new Region(region);
        ClientConfig clientConfig = new ClientConfig(reg);
        clientConfig.setHttpProtocol(HttpProtocol.https); // 使用HTTPS協(xié)議
        COSClient cosClient = new COSClient(cred, clientConfig);

        try {
            // 4. 指定文件上傳到COS后的路徑和文件名
            String key = "test-images/" + localFile.getName(); // COS中的文件路徑
            PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, key, localFile);
            PutObjectResult putObjectResult = cosClient.putObject(putObjectRequest);

            // 5. 如果成功，打印出文件的訪問鏈接
            String url = "https://" + bucketName + ".cos." + region + ".myqcloud.com/" + key;
            System.out.println("? 上傳成功！");
            System.out.println("? 文件訪問URL: " + url);
            // 你可以復制這個URL到瀏覽器，看看能否打開圖片

        } catch (Exception e) {
            System.err.println("? 上傳失敗，錯誤信息: " + e.getMessage());
            e.printStackTrace();
        } finally {
            // 6. 最后一定要關閉客戶端
            cosClient.shutdown();
        }
    }
}

4）點擊文件，運行測試