ossutil(oss命令行工具)是一款管理OSS數據的工具，通過命令行對數據進行創建、列舉或刪除Bucket，或者上傳、下載、拷貝Object等，功能甚多，并且在多個操作系統下都可以使用。如果你在使用過程中遇到了問題，可以試著看看常見問題內是否有對應的解決方法。

軟件功能

通過ossutil，您可以進行如下操作：

管理Bucket，如：創建、列舉或刪除Bucket等。

管理Object，如：上傳、下載、列舉、拷貝和刪除Object等。

管理碎片（part），如：列舉和刪除part等。

安裝方法

Windows系統（以64位系統為例）

下載工具。

將工具解壓到指定的文件夾，并雙擊運行ossutil.bat文件。

生成配置文件，配置參數參考Linux系統的配置參數。

D:\ossutil>ossutil64.exe config

常見問題

本文介紹在使用ossutil時可能出現的問題及處理方法。

使用-u參數上傳文件時出現skip提示

問題分析：使用-u參數上傳文件的時候，ossutil會將上傳文件和存儲空間（Bucket）內已有文件進行一次比對。若發現上傳的文件與目標Bucket內已有文件同名，且該文件的最后修改時間早于或等于Bucket內已有文件，上傳時會跳過該文件；若該文件的最后修改時間晚于Bucket內已有文件，則重新上傳該文件。所以使用-u參數上傳文件時出現skip提示是正常現象。

解決方案：確認Bucket內文件上傳無問題后忽略該提示。

文件解凍時出現403報錯

問題分析：操作解凍文件的過程中出現403，有以下兩種可能性。

若您是使用子賬號操作文件，可能是子賬號權限不足，無目標文件的操作權限。

您文件內容違禁OSS被封禁了。

解決方案：

子賬號權限不足：增加子賬號權限。

文件內容違禁：刪除或忽略該文件。

使用ls命令查看Bucket無文件，刪除Bucket時報錯

問題分析：使用ls命令列舉Bucket內的文件且未攜帶任何選項時，無法列舉碎片、歷史版本文件（僅存在于開啟過版本控制的Bucket）。若Bucket為非空（即Bucket中存在碎片、歷史版本文件），僅使用rm命令無法刪除該Bucket。

解決方案：

先刪除碎片和歷史版本文件（未開啟過版本控制請忽略），再刪除Bucket。

刪除碎片和歷史版本文件。

列舉并刪除碎片：

./ossutil ls oss://bucket1 -m

./ossutil rm -m oss://bucket1 -r

列舉并刪除歷史版本文件：

./ossutil ls oss://bucket1 --all-versions

./ossutil rm oss://bucket1 --all-versions -r

刪除Bucket。

./ossutil rm oss://bucket1 -b

強制刪除Bucket。

若存儲空間未開啟版本控制，使用如下命令強制刪除Bucket：

./ossutil rm oss://bucketname -abrf

若存儲空間已開啟版本控制，使用如下命令強制刪除Bucket：

./ossutil rm oss://bucketname -abrf --all-versions

警告 Bucket及文件被刪除后，無法恢復，請謹慎使用該命令。

文件上傳、下載進度超過100%

問題分析：ossutil在上傳、下載文件時，會自動生成一個名為.ossutil_checkpoint文件夾。當目標文件超過100 MB時，ossutil默認使用斷點續傳上傳或下載目標文件，并將過程中生成的斷點信息文件保存在.ossutil_checkpoint文件夾中。上傳、下載任務完成后，會自動刪除這個文件夾。若單機運行超過一個ossutil實例，且都在進行上傳或下載任務，當其中一個ossutil的任務完成后，會自動刪除.ossutil_checkpoint文件夾，導致其它需要使用斷點續傳的ossutil任務進度超過100%且無法完成。

解決方案：

將當前任務結束，重新開始上傳、下載任務。

在cp命令中加上--checkpoint-dir參數，并手動指定一個與默認checkpoint文件夾不同名的文件夾。例如：

./ossutil cp oss://bucket1/myphoto.jpg  /dir  --checkpoint-dir checkpoint