簡(jiǎn)介面向 Java 開發(fā)者的華為云 OBS 對(duì)象存儲(chǔ)服務(wù) SDK 資源包版本為 3.20.3可幫助快速實(shí)現(xiàn)文件上傳、下載、桶管理及對(duì)象生命周期管理等云存儲(chǔ)操作也適合作為企業(yè)項(xiàng)目二次開發(fā)的基線工具。壓縮包共 766 個(gè)文件整體僅 7.31MB其中包含 449 個(gè) HTML 格式的 API 文檔頁(yè)面、286 個(gè) Java 示例與源碼文件、10 個(gè) XML 工程及日志配置、9 個(gè) JAR 依賴庫(kù)另有 LICENSE、MD 說(shuō)明等配套文件目錄結(jié)構(gòu)清晰便于按需查閱。資源內(nèi)置完整 SDK 庫(kù)、Maven 依賴描述、可直接運(yùn)行的示例代碼以及官方 javadoc 文檔開發(fā)者可據(jù)此搭建 Maven 工程理解核心客戶端接口的調(diào)用方式并參考示例完成上傳、下載、列舉桶、刪除對(duì)象等典型操作日志配置還支持靈活調(diào)整輸出級(jí)別便于聯(lián)調(diào)階段問(wèn)題定位。已有 1833 人學(xué)習(xí)下載適合剛接觸華為云 OBS 的入門者以及需要深度集成 OBS 服務(wù)的后端工程師參考使用。1. 華為 OBS SDK 3.20.3Java 接入對(duì)象存儲(chǔ)時(shí)的離線首選包上個(gè)月給一個(gè)內(nèi)網(wǎng)客戶做數(shù)據(jù)遷移安全策略禁止開發(fā)機(jī)訪問(wèn) Maven 中央倉(cāng)庫(kù)所有第三方 jar 要人工審核后進(jìn)內(nèi)部制品庫(kù)。我把申請(qǐng)遞上去時(shí)順手下載了官方 esdk-obs-java-3.20.3.zip解壓后主包、依賴、源碼和中文文檔齊了離線導(dǎo)入一次通過(guò)。這個(gè) zip 就是華為 OBS SDK 的 Java 發(fā)行包3.20.3 版本提供 ObsClient 全套能力覆蓋桶操作、上傳下載、斷點(diǎn)續(xù)傳和管理策略。對(duì)于不能實(shí)時(shí)拉取依賴的維護(hù)項(xiàng)目手工導(dǎo)入 zip 反而比 Maven 更可控適合內(nèi)網(wǎng)部署、遺留系統(tǒng)升級(jí)、需要審計(jì)依賴的 Java 工程師新手按包內(nèi)示例也能跑通第一行上傳代碼。2. 解包 esdk-obs-java-3.20.3jar 清單、依賴取舍與本地倉(cāng)庫(kù)導(dǎo)入2.1 拆開 zip 先別急著全量引入先認(rèn)目錄拿到 zip 后很多人直接把里面所有 jar 拖進(jìn)項(xiàng)目 libs結(jié)果啟動(dòng)時(shí) log4j 或者 okhttp 沖突。我拆過(guò)幾個(gè) esdk-obs-java 發(fā)行包目錄結(jié)構(gòu)大同小異核心是 esdk-obs-java-3.20.3.jar運(yùn)行期依賴在 lib 或 third_party 目錄下另外會(huì)附 source 包、README、API 文檔和依賴清單。下面這張表是我一般會(huì)先核對(duì)的幾項(xiàng)。文件/目錄內(nèi)容離線審核時(shí)看什么esdk-obs-java-3.20.3.jar主庫(kù)ObsClient、PutObjectRequest 等核心類都在里面確認(rèn)版本號(hào)與文檔一致lib/okhttp-.jar、gson-.jarHTTP 和 JSON 依賴看版本是否和項(xiàng)目現(xiàn)有 jar 沖突esdk-obs-java-3.20.3-source.jar源碼包排查問(wèn)題時(shí)反查實(shí)現(xiàn)doc/中文 API 手冊(cè)與示例先查支持的 Operationsdependency-list.txt依賴清單人工審計(jì)時(shí)逐項(xiàng)打勾先讀依賴清單再?zèng)Q定引哪些 jar。OBS SDK 3.x 的 HTTP 層基于 OkHttp序列化用了 Gson日志用 Log4j2這三類是沖突高發(fā)區(qū)。如果你項(xiàng)目里已經(jīng)有 okhttp 3.14 以上版本不要直接覆蓋先看 SDK 內(nèi)置版本與你的代碼有沒有調(diào)用差異。提示離線審核時(shí)把 dependency-list.txt 和 source jar 一起歸檔后續(xù)等保檢查或制品溯源都要用。2.2 從 libs 走向內(nèi)部 Maven兩種導(dǎo)入方式對(duì)比第一種方式IDE 項(xiàng)目直接把 jar 放入 libs 目錄并加入 module 依賴。速度快但每個(gè)項(xiàng)目都要重復(fù)手工步驟構(gòu)建產(chǎn)物也不統(tǒng)一我一般只用來(lái)做本地驗(yàn)證。第二種方式更可靠把 SDK 主包和第三方依賴統(tǒng)一安裝到內(nèi)部 Maven 倉(cāng)庫(kù)pom 里只寫一個(gè)坐標(biāo)。# 安裝 SDK 主包 mvn install:install-file \ -Dfileesdk-obs-java-3.20.3.jar \ -DgroupIdcom.huaweicloud \ -DartifactIdesdk-obs-java \ -Dversion3.20.3 \ -Dpackagingjar # 如果有源碼包需要一起發(fā)布再加 -Dclassifiersources mvn install:install-file \ -Dfileesdk-obs-java-3.20.3-source.jar \ -DgroupIdcom.huaweicloud \ -DartifactIdesdk-obs-java \ -Dversion3.20.3 \ -Dpackagingjar \ -Dclassifiersourcesinstall-file會(huì)安裝一個(gè) jar相當(dāng)于把本地文件“發(fā)布”到本地倉(cāng)庫(kù)。-DgroupId/-DartifactId/-Dversion必須和后續(xù) pom 坐標(biāo)一致否則構(gòu)建時(shí)找不到。我不建議把版本改寫成 3.20.3-RELEASE 這類自定義版本問(wèn)題定位時(shí)對(duì)不上原始包會(huì)很難受。之后項(xiàng)目 pom 里聲明依賴dependency groupIdcom.huaweicloud/groupId artifactIdesdk-obs-java/artifactId version3.20.3/version /dependency如果內(nèi)部 Maven 倉(cāng)庫(kù)還沒有 okhttp、gson 這些第三方依賴同樣需要先把它們安裝進(jìn)倉(cāng)庫(kù)否則 Maven 構(gòu)建時(shí)依舊解析失敗。此時(shí)可以執(zhí)行mvn dependency:tree看 SDK 的傳遞依賴再?zèng)Q定逐個(gè) install 還是直接用項(xiàng)目?jī)?nèi)已有版本覆蓋。2.3 依賴沖突高發(fā)點(diǎn)OkHttp 與 Log4j2 的取舍我在給老 Spring Boot 項(xiàng)目接 OBS SDK 時(shí)遇到最多的是NoSuchMethodError: okhttp3.RequestBody.create。原因很簡(jiǎn)單系統(tǒng)里已有舊版 okhttpOBS SDK 編譯時(shí)用了新版的靜態(tài)方法運(yùn)行時(shí)加載了老 class直接炸。解決方式是先從依賴?yán)锱懦?SDK 自帶的 okhttp統(tǒng)一走項(xiàng)目里的版本。dependency groupIdcom.huaweicloud/groupId artifactIdesdk-obs-java/artifactId version3.20.3/version exclusions exclusion groupIdcom.squareup.okhttp3/groupId artifactIdokhttp/artifactId /exclusion /exclusions /dependency排除前要確認(rèn)項(xiàng)目現(xiàn)有 okhttp 版本不被 SDK 調(diào)用的新 API 影響否則會(huì)出現(xiàn)暗坑。Log4j2 沖突也一樣如果項(xiàng)目已經(jīng)有 log4j2需要檢查版本是否高于 SDK 要求實(shí)在無(wú)法統(tǒng)一時(shí)可以在部署層做 shiro/日志橋接但那是最后手段。更穩(wěn)妥的做法是先跑一遍mvn dependency:tree -Dincludescom.squareup.okhttp3看清依賴來(lái)源再?zèng)Q定排除哪一端。除了 Maven老 Web 項(xiàng)目常直接拷貝 jar 到WEB-INF/lib。這時(shí)我建議只拷貝 dependency-list.txt 里標(biāo)為 compile 的 jar并按主包在前、第三方在后的順序加入。主包是否完整可以用jar tf快速驗(yàn)證jar tf esdk-obs-java-3.20.3.jar | grep ObsClient能看到com/obs/services/ObsClient.class基本沒問(wèn)題。這一步能攔住絕大多數(shù)“jar 包損壞”或“下載不完整”的翻車。3. 初始化 ObsClientAK/SK、Endpoint 與連接參數(shù)的一次配好3.1 創(chuàng)建 ObsClient最小可用代碼與線程安全說(shuō)明接入 OBS 的第一步是拿到ObsClient。最小代碼如下import com.obs.services.ObsClient; public class ObsConnection { public static void main(String[] args) throws Exception { String endpoint https://obs.cn-north-4.myhuaweicloud.com; String ak System.getenv(OBS_AK); String sk System.getenv(OBS_SK); ObsClient client new ObsClient(ak, sk, endpoint); System.out.println(client.listBuckets()); client.close(); } }ObsClient封裝了 HTTP 調(diào)用、簽名計(jì)算、連接池和重試。構(gòu)造函數(shù)只做參數(shù)初始化不會(huì)立刻聯(lián)網(wǎng)上方代碼里的listBuckets()會(huì)真實(shí)調(diào)用一次 OBS 服務(wù)用來(lái)驗(yàn)證 AK/SK 是否有效。ObsClient 是線程安全的應(yīng)用啟動(dòng)時(shí)創(chuàng)建一個(gè)全局單例即可不要每次上傳都 new。每 new 一個(gè)都會(huì)占住一個(gè)連接池和對(duì)應(yīng)線程資源調(diào)用頻率高時(shí)很容易把 JVM 的句柄數(shù)跑上去。如果想控制超時(shí)、連接池大小和重試次數(shù)要先用ObsConfigurationObsConfiguration config new ObsConfiguration(); config.setEndPoint(https://obs.cn-north-4.myhuaweicloud.com); config.setConnectionTimeout(10000); config.setSocketTimeout(30000); config.setMaxConnections(500); config.setMaxErrorRetry(3); ObsClient client new ObsClient(ak, sk, config);這里注意方法名是setEndPoint別寫成setEndpointIDE 提示時(shí)容易看走眼。connectionTimeout是建立 TCP 連接的超時(shí)socketTimeout是每次讀響應(yīng)的超時(shí)maxConnections是連接池上限maxErrorRetry是網(wǎng)絡(luò)層錯(cuò)誤的重試次數(shù)。重試次數(shù)不是越大越好接口冪等性差時(shí)重試會(huì)放大臟數(shù)據(jù)風(fēng)險(xiǎn)。3.2 AK/SK、Endpoint 與 Region 的關(guān)系Endpoint 決定了你的請(qǐng)求發(fā)到哪個(gè)區(qū)域的 OBS 服務(wù)端。常見區(qū)域?qū)?yīng)關(guān)系如下區(qū)域Endpoint華北-北京四obs.cn-north-4.myhuaweicloud.com華南-廣州obs.cn-south-1.myhuaweicloud.com華東-上海一obs.cn-east-3.myhuaweicloud.comEndpoint 不要帶桶名也不要帶端口號(hào)。錯(cuò)誤寫法是https://my-bucket.obs.cn-north-4.myhuaweicloud.com這樣簽名時(shí) Host 會(huì)多一層服務(wù)端解析后大概率報(bào) 301 或 NoSuchBucket。如果 VPC 內(nèi)網(wǎng)訪問(wèn)應(yīng)該用對(duì)應(yīng)區(qū)域的內(nèi)網(wǎng)域名AK/SK 不需要變化。另外桶是有區(qū)域?qū)傩缘?。用北京四?Endpoint 去訪問(wèn)華南廣州的桶請(qǐng)求會(huì)被重定向或直接拒絕。我應(yīng)該把區(qū)域配置放到統(tǒng)一配置中心而不是寫死在代碼里?？鐓^(qū)域訪問(wèn)場(chǎng)景還要考慮流量費(fèi)用Endpoint 只是技術(shù)入口不代表業(yè)務(wù)上可以隨意跨區(qū)拉文件。3.3 AK/SK 不要寫死在代碼里環(huán)境變量與臨時(shí)憑證最常見的錯(cuò)誤是把 AK/SK 直接粘貼在代碼里然后代碼被傳到 Git 倉(cāng)庫(kù)。我習(xí)慣先從環(huán)境變量讀取String ak System.getenv(OBS_AK); String sk System.getenv(OBS_SK); if (ak null || sk null) { throw new IllegalStateException(missing OBS_AK or OBS_SK in env); }在本地開發(fā)時(shí)可以把密鑰放在~/.obs/credentials這類外部文件生產(chǎn)環(huán)境在華為云 CCE/ECS 上運(yùn)行時(shí)優(yōu)先使用委托方式獲取臨時(shí)憑證這樣即使容器被攻破拿到的也是短期憑證而不是永久 AK/SK。臨時(shí)憑證方案一般涉及華為云 IAM 的 STS 服務(wù)SDK 里對(duì)應(yīng)ObsClient的 credentials provider 參數(shù)。換憑證時(shí)不需要重建 ObsClient只需要確認(rèn)新憑證有對(duì)應(yīng)的 obs:Object:* 權(quán)限。如果使用獨(dú)立的配置中心讀取后也要保證進(jìn)程內(nèi)存中只有一份不要反復(fù)讀取。密鑰明文落盤的風(fēng)險(xiǎn)比代碼硬編碼更難發(fā)現(xiàn)尤其是配置文件被鏡像打包時(shí)很容易一并在鏡像里泄露出去。4. 上傳下載實(shí)戰(zhàn)PutObject、GetObject 與斷點(diǎn)續(xù)傳的參數(shù)選擇4.1 簡(jiǎn)單上傳與下載流式處理必須記住關(guān)閉響應(yīng)體普通小文件直接使用PutObjectRequest最省事。以字符串上傳為例PutObjectRequest putRequest new PutObjectRequest( my-bucket, logs/app-2025-01.log, 2025-01-01 00:00:00); obsClient.putObject(putRequest);這個(gè)構(gòu)造函數(shù)里填的是桶名、對(duì)象名、字符串內(nèi)容。對(duì)象名即 keylogs/只是模擬目錄層級(jí)OBS 并沒有真實(shí)目錄概念。如果上傳本地文件代碼變成File file new File(app-2025-01.log); PutObjectRequest putRequest new PutObjectRequest(my-bucket, logs/ file.getName(), file); ObjectMetadata metadata new ObjectMetadata(); metadata.setContentType(text/plain); metadata.setContentLength(file.length()); putRequest.setMetadata(metadata); obsClient.putObject(putRequest);metadata.setContentType顯式聲明文件類型避免瀏覽器下載.log文件時(shí)被當(dāng)成純文本展示。setContentLength一般會(huì)自動(dòng)計(jì)算手動(dòng)設(shè)置時(shí)要注意和文件實(shí)際長(zhǎng)度一致否則可能出現(xiàn)請(qǐng)求 body 和服務(wù)端長(zhǎng)度對(duì)不上。下載時(shí)服務(wù)端返回的是ObsObject真正的數(shù)據(jù)在getObjectContent()流里GetObjectRequest getRequest new GetObjectRequest(my-bucket, logs/app-2025-01.log); ObsObject object obsClient.getObject(getRequest); try (InputStream in object.getObjectContent()) { Files.copy(in, Paths.get(downloads/app-2025-01.log), StandardCopyOption.REPLACE_EXISTING); } catch (IOException e) { throw new RuntimeException(download failed, e); }getObject不會(huì)把整個(gè)文件讀進(jìn)內(nèi)存而是返回一個(gè)可讀流。這個(gè)流必須被讀取并關(guān)閉否則 TCP 連接無(wú)法回到連接池。程序跑幾天后連接數(shù)和文件句柄會(huì)肉眼可見地增長(zhǎng)。這里用 try-with-resources 是最穩(wěn)妥的關(guān)閉方式不要在 finally 里再寫一遍close()容易重復(fù)關(guān)閉。4.2 大文件與弱網(wǎng)uploadFile 和 downloadFile 斷點(diǎn)續(xù)傳超過(guò) 100MB 的文件不建議用putObject(File)。這個(gè)接口適合小對(duì)象網(wǎng)絡(luò)抖動(dòng)一次就要重來(lái)。OBS Java SDK 提供了專門的大文件接口示例代碼UploadFileRequest request new UploadFileRequest( my-bucket, archives/backup.zip, D:/data/backup.zip); request.setTaskNum(5); request.setPartSize(10 * 1024 * 1024); request.setEnableCheckpoint(true); obsClient.uploadFile(request);對(duì)應(yīng)的下載DownloadFileRequest request new DownloadFileRequest( my-bucket, archives/backup.zip, D:/data/download/backup.zip); request.setTaskNum(8); request.setEnableCheckpoint(true); request.setPartSize(10 * 1024 * 1024); obsClient.downloadFile(request);taskNum是并發(fā)分片數(shù)partSize是單個(gè)分片大小。兩者共同決定內(nèi)存占用和并發(fā)壓力。我一般把partSize設(shè)在 5~10MBtaskNum不超過(guò) 10弱網(wǎng)環(huán)境下 taskNum 太大反而加劇超時(shí)因?yàn)槊總€(gè)分片都在搶帶寬。enableCheckpoint開啟后會(huì)在本地生成分片進(jìn)度記錄中斷后再次調(diào)用會(huì)從斷點(diǎn)繼續(xù)。但要注意如果業(yè)務(wù)文件內(nèi)容變了必須清掉舊 checkpoint 記錄否則可能把不同版本的分片拼接在一起得到臟數(shù)據(jù)。4.3 怎么選上傳方式簡(jiǎn)單上傳、流式上傳、斷點(diǎn)續(xù)傳的邊界方式適用場(chǎng)景注意點(diǎn)putObject(File)小于 100MB 的普通文件簡(jiǎn)單直接不能斷點(diǎn)續(xù)傳putObject(InputStream)請(qǐng)求流、管道數(shù)據(jù)需要自己處理異常關(guān)閉uploadFile大文件、弱網(wǎng)、需要重試分片數(shù)不能超過(guò) 10000partSize 影響并發(fā)追加上傳 AppendObject日志順序追加不支持并發(fā)追加追加次數(shù)有限制選擇依據(jù)主要看文件大小和網(wǎng)絡(luò)穩(wěn)定性。小文件在弱網(wǎng)環(huán)境下直接重試幾次成本也不高大文件必須用uploadFile它內(nèi)部會(huì)做分片并發(fā)和進(jìn)度持久化。如果你在代碼里給多個(gè)線程分別調(diào)putObject(File)上傳同一個(gè)大文件那不是斷點(diǎn)續(xù)傳只會(huì)多占內(nèi)存和帶寬。另外uploadFile底層走的是 OBS 的 multipart upload對(duì)同一對(duì)象發(fā)起的分片上傳任務(wù)數(shù)量有限制。如果長(zhǎng)時(shí)間只傳不合并或者頻繁取消服務(wù)端會(huì)積累未完成的分片產(chǎn)生額外存儲(chǔ)費(fèi)用。生產(chǎn)環(huán)境要定期清理未完成的分片任務(wù)或者監(jiān)控桶里的 multipart 數(shù)量。5. 避坑與常見問(wèn)題排查OBS Java SDK 最常翻車的五個(gè)細(xì)節(jié)5.1 桶名帶上了 Endpoint301/404 反復(fù)出現(xiàn)現(xiàn)象請(qǐng)求返回 301或者桶明明存在卻報(bào) NoSuchBucket。原因Endpoint 寫成了“桶名 域名”。SDK 的 endpoint 只接受區(qū)域域名桶名是請(qǐng)求參數(shù)里的獨(dú)立項(xiàng)把桶名拼進(jìn)去后 Host 頭就多了一層簽名驗(yàn)證自然失敗。解決Endpoint 統(tǒng)一填https://obs.cn-north-4.myhuaweicloud.com桶名只寫在PutObjectRequest/GetObjectRequest的構(gòu)造參數(shù)里。CDN 或自定義域名場(chǎng)景需要單獨(dú)配置 path style不應(yīng)該用普通 endpoint 硬拼。5.2 AK/SK 正確但還是 AccessDenied現(xiàn)象本地用同樣 AK/SK 能訪問(wèn)部署到客戶環(huán)境后總是 AccessDenied。原因IAM 用戶權(quán)限不夠、臨時(shí)憑證作用域不對(duì)或者客戶端系統(tǒng)時(shí)間與服務(wù)器偏差過(guò)大導(dǎo)致簽名過(guò)期。也可能桶策略限制了來(lái)源 IP 或指定了請(qǐng)求頭。解決先檢查 IAM 策略是否包含obs:Object:PutObject、obs:Object:GetObject。如果用的是臨時(shí)憑證確認(rèn)角色策略是否完整。然后看服務(wù)器系統(tǒng)時(shí)間偏差超過(guò) 15 分鐘就先做時(shí)間同步。OBS 簽名用的是 UTC 時(shí)間不會(huì)自動(dòng)跟隨本地時(shí)區(qū)時(shí)間偏移是最隱蔽的 AccessDenied 原因。5.3 大文件上傳內(nèi)存爆掉現(xiàn)象用putObject(new File(...))上傳 500MB 文件JVM 內(nèi)存飆升并出現(xiàn) OOM加-Xmx4g也沒用。原因簡(jiǎn)單上傳接口在構(gòu)造請(qǐng)求時(shí)可能會(huì)額外加載整個(gè)文件或較大的緩沖區(qū)域同時(shí)大文件本身也增加了 IO 壓力堆內(nèi)存很快被占滿。解決改用UploadFileRequest分片上傳partSize控制在 5~10MBtaskNum控制在 2~8。同時(shí)在ObsConfiguration里調(diào)整maxConnections避免每個(gè)分片線程都持有大緩沖。如果業(yè)務(wù)上必須用簡(jiǎn)單上傳就用InputStream并顯式控制讀緩沖不要直接把整個(gè) File 交給 SDK。5.4 代理環(huán)境下連接池被占滿現(xiàn)象內(nèi)網(wǎng)請(qǐng)求走 HTTP 代理剛開始正常一段時(shí)間后所有請(qǐng)求 SocketTimeout。原因ObsClient 默認(rèn)使用 okhttp 連接池maxConnections 默認(rèn)值不夠大。代理環(huán)境下每次請(qǐng)求都要額外握手長(zhǎng)連接失效后大量建連互相爭(zhēng)搶最終連接池被占滿。解決在ObsConfiguration中顯式配置代理和連接池參數(shù)config.setProxyHost(proxy.internal); config.setProxyPort(8080); config.setMaxConnections(200);maxConnections 建議按業(yè)務(wù)峰值的 1.2 倍左右設(shè)置。同時(shí)觀察 okhttp 的 eviction 日志確認(rèn)代理本身沒有并發(fā)連接數(shù)限制。如果代理還做了 TLS 攔截還需要把相應(yīng)證書導(dǎo)入到 JVM 的 trustStore否則會(huì)報(bào) SSLHandshakeException。5.5 依賴沖突導(dǎo)致 NoSuchMethodError現(xiàn)象項(xiàng)目啟動(dòng)后調(diào)用 OBS SDK 報(bào)NoSuchMethodError: okhttp3.RequestBody.create(...)。原因項(xiàng)目里另一個(gè)依賴帶了舊版 okhttp把 OBS SDK 依賴的 okhttp 版本覆蓋了運(yùn)行時(shí)加載的類缺少新版方法。解決在 pom 里排除 OBS SDK 自帶的 okhttp統(tǒng)一用項(xiàng)目?jī)?nèi)較新的版本如果項(xiàng)目?jī)?nèi)版本過(guò)舊就反過(guò)來(lái)升級(jí)項(xiàng)目依賴。查看依賴樹是關(guān)鍵mvn dependency:tree -Dincludescom.squareup.okhttp3看到重復(fù)的 okhttp 版本后再?zèng)Q定排除哪一邊。日志沖突同理優(yōu)先保證 log4j2 高版本被加載否則 SDK 的日志輸出會(huì)靜默失敗排查問(wèn)題時(shí)看不到任何請(qǐng)求信息。6. 進(jìn)階用法并發(fā)上傳與日志驗(yàn)證讓 SDK 吞吐量真正跑起來(lái)6.1 線程池并發(fā)上傳配合連接池和日志驗(yàn)證ObsClient 是線程安全的所以并發(fā)上傳小文件時(shí)可以直接用固定線程池。常見做法是ExecutorService pool Executors.newFixedThreadPool(8); ListPath files ...; for (Path path : files) { pool.submit(() - { obsClient.putObject(my-bucket, path.getFileName().toString(), path.toFile()); }); } pool.shutdown(); pool.awaitTermination(30, TimeUnit.MINUTES);線程數(shù)不要盲目往上漲。ObsConfiguration 里的maxConnections要跟著調(diào)大否則所有線程都在等連接池整體吞吐反而下降。對(duì)于大文件UploadFileRequest內(nèi)部已經(jīng)做了分片并發(fā)不要再在外面套一層多線程去并發(fā)刷同一個(gè)文件分片競(jìng)爭(zhēng)會(huì)拖慢速度。上線前我習(xí)慣把日志調(diào)出來(lái)看一眼OBS SDK 內(nèi)部使用 log4j2logger 名稱一般是com.obs.services。把這一級(jí)調(diào)到 DEBUG可以看到簽名的 Host、請(qǐng)求路徑和響應(yīng)狀態(tài)碼。確認(rèn)請(qǐng)求路徑里沒有多余的桶名再放開并發(fā)壓測(cè)。驗(yàn)證上傳是否成功不一定要下載回來(lái)?？梢宰x對(duì)象元數(shù)據(jù)做一致性判斷ObjectMetadata meta obsClient.getObjectMetadata(my-bucket, logs/app.log); System.out.println(meta.getContentLength());把元數(shù)據(jù)里的 contentLength 和本地文件大小比對(duì)能快速發(fā)現(xiàn)未傳完或傳錯(cuò)對(duì)象的問(wèn)題。再用v2: obs://bucket/key這類方式做一次下載校驗(yàn)比較穩(wěn)妥。之前我為了追求并發(fā)把線程池開到 32連接池沒調(diào)壓測(cè)到第 20 分鐘就開始大片超時(shí)后來(lái)把 maxConnections 和線程數(shù)一起控制在 16實(shí)測(cè)吞吐才穩(wěn)定下來(lái)。從那以后我每次接 OBS SDK 都強(qiáng)制做一遍 20 分鐘并發(fā)壓測(cè)確認(rèn) CPU、句柄和超時(shí)三個(gè)指標(biāo)沒有異常才敢上線。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取